safe-expr-eval

JavaScript 및 TypeScript를 위한 빠르고 가벼운 표현식 평가기.

익숙한 API, 제로 종속성, 완전한 TypeScript 지원을 갖춘 현대적인 표현식 파서입니다.

---

기능

• 빠른 표현식 파싱 및 평가
• 가벼우며 종속성 없음
• 완전한 TypeScript 지원
• 간단하고 익숙한 API
• 사용자 정의 함수 및 상수
• ES2020+ 호환
• 철저히 테스트됨

---

설치

npm install safe-expr-eval

---

빠른 시작

기본 사용법

import { Parser } from 'safe-expr-eval';

const parser = new Parser();
const expr = parser.parse('2 * x + 1');

console.log(expr.evaluate({ x: 3 })); // 7
console.log(expr.evaluate({ x: 10 })); // 21

---

직접 평가

import { evaluate } from 'safe-expr-eval';

const result = evaluate('10 + 5 * 2');

console.log(result); // 20

---

컴파일된 표현식

import { compile } from 'safe-expr-eval';

const fn = compile('price * quantity * (1 - discount)');

console.log(
  fn({
    price: 100,
    quantity: 2,
    discount: 0.1
  })
); // 180

---

지원되는 연산

산술

+  -  *  /  %

비교

==  !=  >  <  >=  <=

논리

and  or  not
&&   ||   !

---

데이터 타입

Numbers   → 42, 3.14
Strings   → "hello"
Booleans  → true, false
Variables → price, user.name

---

사용자 정의 함수

const parser = new Parser();

parser.functions.max = Math.max;
parser.functions.min = Math.min;
parser.functions.round = Math.round;

const expr = parser.parse(
  'round(max(a, b) * 1.5)'
);

console.log(
  expr.evaluate({
    a: 10,
    b: 20
  })
); // 30

---

상수

const parser = new Parser();

parser.consts.PI = Math.PI;
parser.consts.TAX_RATE = 0.15;

const expr = parser.parse(
  'price * (1 + TAX_RATE)'
);

console.log(
  expr.evaluate({
    price: 100
  })
); // 115

---

API

Parser

파서 생성

new Parser()

표현식 파싱

parser.parse(expression)

표현식 평가

parser.evaluate(expression, variables?)

함수 레지스트리

parser.functions

상수 레지스트리

parser.consts

---

독립형 함수

evaluate

evaluate(expression, variables?)

compile

compile(expression)

---

테스트

npm test

npm run test:coverage

---

라이선스

MIT

자세한 내용은 LICENSE 파일을 참조하세요.

---

기여

풀 리퀘스트 및 기여를 환영합니다.

---

이슈

버그를 발견하거나 기능 요청이 있으면 이슈를 열어 주세요.

---

작성자

Alejandro Castrillon

GitHub: https://github.com/