Adds a convenient prototype function package.

Getting started

Import the package to the first file you call.

``

js

import "prototype-helper";



// and use

console.log("10000".toComma()); // 10,000





Prototype Helper



Number



$3



- Returns the primitive value of a Number instance.



- Number 인스턴스의 기본값을 반환하는 메서드입니다.

ts

expect((3.141592).toNumber()).toBe(3.141592);

expect((12345).toNumber()).toBe(12345);

expect((3.14).toNumber()).toBe(3.14);





$3



- Converts a Number instance to a Decimal instance.



- Number 인스턴스를 Decimal 인스턴스로 변환하는 메서드입니다.

ts

expect((3.141592).toDecimal()).toStrictEqual(new Decimal(3.141592));

expect((12345).toDecimal()).toStrictEqual(new Decimal(12345));

expect(NaN.toDecimal().isNaN()).toBeTruthy();





$3



- Returns a string representation of a number with commas.



- 숫자를 쉼표로 구분한 문자열로 변환하는 메서드입니다.

ts

expect((3141592).toComma()).toBe("3,141,592");

expect((0).toComma()).toBe("0");

expect((-100000).toComma()).toBe("-100,000");





$3



- Calculates the modulo of a number with another number.



- 한 숫자를 다른 숫자로 나눈 나머지를 반환하는 메서드입니다.

ts

expect((7).mod(3)).toBe(1);

expect((100).mod(7)).toBe(2);





$3



- Divides a number by another number.



- 한 숫자를 다른 숫자로 나눈 결과를 반환하는 메서드입니다.

ts

expect((10).div(2)).toBe(5);

expect((8).div(3)).toBeCloseTo(2.6667, 4);





$3



- Multiplies a number by another number.



- 한 숫자에 다른 숫자를 곱한 결과를 반환하는 메서드입니다.

ts

expect((4).mul(3)).toBe(12);

expect((5).mul(0.5)).toBeCloseTo(2.5, 4);





$3



- Adds another number to a number.



- 한 숫자에 다른 숫자를 더한 결과를 반환하는 메서드입니다.

ts

expect((8).add(3)).toEqual(11);

expect((100).add(1.25)).toEqual(101.25);





$3



- Subtracts another number from a number.



- 한 숫자에서 다른 숫자를 뺀 결과를 반환하는 메서드입니다.

ts

expect((8).sub(3)).toEqual(5);

expect((100).sub(1.25)).toEqual(98.75);





$3



- Returns a string representation of an integer with fixed length.



- 정수를 지정한 자릿수만큼 0으로 채워 반환하는 메서드입니다.

ts

expect((1234).fixNumber(8)).toBe("00001234");

expect((1234).fixNumber(4)).toBe("1234");





$3



- Returns a string representation of a number with fixed decimal places.



- 소수점 이하 자릿수를 맞추어 반환하는 메서드입니다.

ts

expect((1234).fixPoint(8)).toBe("1234.00000000");

expect((1234.5678).fixPoint(2)).toBe("1234.56");





$3



- Returns the absolute value of a number.



- 숫자의 절대값을 반환하는 메서드입니다.

ts

expect((-3).abs()).toBe(3);

expect((3.14).abs()).toBe(3.14);

expect((0).abs()).toBe(0);





$3



- Checks if a number is finite.



- 숫자가 유한한지 검사하는 메서드입니다.

ts

expect((-5).isFinite()).toBe(true);

expect((1 / 0).isFinite()).toBe(false);

expect((-1 / 0).isFinite()).toBe(false);





$3



- Checks if a number is NaN.



- 숫자가 NaN인지 검사하는 메서드입니다.

ts

expect(NaN.isNaN()).toBe(true);

expect((0 / 0).isNaN()).toBe(true);

expect((-1).isNaN()).toBe(false);





$3



- Checks if a number is an integer.



- 숫자가 정수인지 검사하는 메서드입니다.

ts

expect((3).isInteger()).toBe(true);

expect((3.0).isInteger()).toBe(true);

expect((-3.1).isInteger()).toBe(false);





$3



- Adds a plus or minus symbol to a number.



- 숫자에 부호 기호를 추가하는 메서드입니다.

ts

expect((10).addSymbol()).toBe("+10");

expect((0).addSymbol()).toBe("0");

expect((-10).addSymbol()).toBe("-10");





$3



- Calculates a value from a percentage of another value.



- 다른 숫자의 백분율 값을 계산하는 메서드입니다.

ts

expect((100).percentOf(50)).toBe(50);

expect((200).percentOf(25)).toBe(50);

expect((50).percentOf(10)).toBe(5);





$3



- Calculates a percentage of a value.



- 숫자의 백분율 값을 계산하는 메서드입니다.

ts

expect((50).toPercent(100)).toBe(50);

expect((50).toPercent(200)).toBe(25);

expect((5).toPercent(50)).toBe(10);





$3



- Returns a number raised to a power.



- 숫자를 지수로 거듭제곱한 결과를 반환하는 메서드입니다.

ts

expect((10).pow(2)).toEqual(100);

expect((2).pow(10)).toEqual(1024);





$3



- Returns a number squared.



- 숫자를 제곱한 결과를 반환하는 메서드입니다.

ts

expect((2).normalize()).toEqual(4);

expect((3.1415).normalize()).toEqual(9.86902225);





$3



- Rounds a number up to the nearest integer or decimal point.



- 숫자를 가장 가까운 정수나 소수점으로 올림하는 메서드입니다.

ts

expect((3.14159).ceil()).toBe(4);

expect((3.14159).ceil(1)).toBe(3.2);

expect((1234).ceil(-2)).toBe(1300);





$3



- Returns the largest integer less than or equal to a given number.



- 주어진 숫자보다 작거나 같은 가장 큰 정수를 반환합니다.

ts

expect((3.14159).floor()).toBe(3);

expect((3.14159).floor(1)).toBe(3.1);

expect((1234).floor(-2)).toBe(1200);





$3



- Returns the value of a number rounded to the nearest integer.



- 주어진 숫자를 가장 가까운 정수로 반올림하여 반환합니다.

ts

expect((3.14159).round()).toBe(3);

expect((3.14159).round(1)).toBe(3.1);

expect((3.14159).round(3)).toBe(3.142);

expect((1234).round(-2)).toBe(1200);





$3



- Returns a human-readable file size string.



- 숫자를 읽기 쉬운 파일 크기 단위(B, KB, MB 등)로 변환합니다.

ts

expect((1024).toFileSize()).toBe("1.00KB");

expect((1048576).toFileSize()).toBe("1.00MB");





$3



- Checks if a number is between a specified range (inclusive).



- 숫자가 지정된 범위 내에 있는지 확인합니다.

ts

expect((5).isBetween(1, 10)).toBe(true);

expect((15).isBetween(1, 10)).toBe(false);





---



String



$3



- Returns a string representation of a number with fixed decimal places.



- 소수점 이하 자릿수를 맞추어 반환하는 메서드입니다.

ts

const str = "123";

const result = str.fixPoint(2);

expect(result).toEqual("123.00");





$3



- Returns a string representation of a number with fixed integer digits.



- 정수 자릿수를 맞추어 반환하는 메서드입니다.

ts

const input = "123.45";

const output = input.fixNumber(5);

expect(output).toBe("00123.45");





$3



- Returns a string with specified characters prepended to the original string.



- 문자열의 시작 부분에 주어진 문자열 또는 숫자를 주어진 길이만큼 채우는 메서드입니다.

ts

const str = "123";

const result = str.leadingChars("0", 5);

expect(result).toEqual("00123");





$3



- Returns a string representation of a number with commas separating groups of thousands.



- 숫자에 쉼표를 추가하여 반환하는 메서드입니다.

ts

expect("123".toComma()).toBe("123");

expect("1234".toComma()).toBe("1,234");

expect("12345".toComma()).toBe("12,345");





$3



- Returns the number representation of a string.



- 문자열을 숫자로 변환하여 반환하는 메서드입니다.

ts

expect("3.14".toNumber()).toBe(3.14);

expect("12345".toNumber()).toBe(12345);





$3



- Returns a string with a symbol added in front, where the symbol is "+" if the number is positive, "-" if it is negative, or an empty string if it is zero.



- 숫자에 부호를 추가하여 반환하는 메서드입니다.

ts

expect("123".addSymbol()).toBe("+123");

expect("-123".addSymbol()).toBe("-123");

expect("0".addSymbol()).toBe("0");

expect("123".addSymbol(" ")).toBe("+ 123");





$3



- Parses a JSON string and returns the resulting object.



- JSON 문자열을 파싱하여 객체로 변환하는 메서드입니다.

ts

const jsonString = '{"name": "John", "age": 30}';

const parsedObject = jsonString.fromJson(); // or fromJSON(), parseJson()

expect(parsedObject).toEqual({ name: "John", age: 30 });





$3



- Returns true if the given word exists in the string, false otherwise.



- 주어진 문자열이 해당 문자열에 포함되어 있는지 여부를 반환하는 메서드입니다.

ts

const string = "The quick brown fox jumps over the lazy dog";

expect(string.issetWord("cat")).toBe(false);





$3



- Returns a substring of the string that contains only the character at the specified index.



- 문자열에서 주어진 인덱스에 해당하는 문자를 반환하는 메서드입니다.

ts

const string = "Hello, world!";

expect(string.getChar(0)).toBe("H");

expect(string.getChar(7)).toBe("w");





$3



- Returns true if the given value is a number, false otherwise.



- 주어진 값이 숫자인지 여부를 반환하는 메서드입니다.

ts

expect("42".isNumber()).toBe(true);

expect("0xFF".isNumber()).toBe(true);

expect("()".isNumber()).toBe(false);

expect("hello".isNumber()).toBe(false);





$3



- Converts a string to camelCase.



- 문자열을 camelCase 형식으로 변환합니다.

ts

expect("hello world".toCamelCase()).toBe("helloWorld");





$3



- Converts a string to snake_case.



- 문자열을 snake_case 형식으로 변환합니다.

ts

expect("helloWorld".toSnakeCase()).toBe("hello_world");





$3



- Converts a string to kebab-case.



- 문자열을 kebab-case 형식으로 변환합니다.

ts

expect("helloWorld".toKebabCase()).toBe("hello-world");





$3



- Truncates a string to a specified length and appends a suffix.



- 문자열을 지정된 길이로 자르고 접미사를 추가합니다.

ts

expect("hello world".truncate(5)).toBe("hello...");





$3



- Capitalizes the first letter of a string.



- 문자열의 첫 글자를 대문자로 변환합니다.

ts

expect("hello".capitalize()).toBe("Hello");





Object



$3



- Returns a deep copy of the current object.



- 현재 객체의 깊은 복사본을 반환합니다.



$3



- Returns a JSON string representation of the current object.



- 현재 객체의 JSON 문자열 표현을 반환합니다.



$3



- Checks if an object is empty.



- 객체가 비어 있는지 확인합니다.

ts

expect({}._isEmpty()).toBe(true);

expect({ a: 1 }._isEmpty()).toBe(false);





$3



- Creates a new object composed of the picked object properties.



- 객체에서 특정 키만 선택하여 새로운 객체를 생성합니다.

ts

const obj = { a: 1, b: 2, c: 3 };

expect(obj._pick(["a", "c"])).toEqual({ a: 1, c: 3 });





$3



- Creates a new object composed of the properties not omitted.



- 객체에서 특정 키를 제외한 새로운 객체를 생성합니다.

ts

const obj = { a: 1, b: 2, c: 3 };

expect(obj._omit(["b"])).toEqual({ a: 1, c: 3 });





$3



- Merges the enumerable properties of one or more source objects into the target object.



- 하나 이상의 소스 객체의 열거 가능한 속성을 대상 객체로 병합합니다.



$3



- Returns an array of a given object's own enumerable string-keyed property names.



- 객체의 고유한 열거 가능한 문자열 키 속성 이름들의 배열을 반환합니다.



$3



- Returns an array of a given object's own enumerable string-keyed property values.



- 객체의 고유한 열거 가능한 문자열 키 속성 값들의 배열을 반환합니다.



$3



- Returns an array of a given object's own enumerable string-keyed property [key, value] pairs.



- 객체의 고유한 열거 가능한 문자열 키 속성의 [키, 값] 쌍들의 배열을 반환합니다.



$3



- Executes a provided function once for each object entry.



- 객체의 각 엔트리에 대해 제공된 함수를 한 번씩 실행합니다.



Array



$3



- Returns the only element of a sequence that satisfies a specified condition, and throws an error if more than one such element exists.



- 조건을 만족하는 시퀀스의 유일한 요소를 반환하며, 해당 조건을 만족하는 요소가 두 개 이상 존재하는 경우 에러를 발생시킵니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.single((x) => x === 3);

expect(result).toBe(3);





$3



- Returns the only element of a sequence that satisfies a specified condition or a default value if no such element exists, and throws an error if more than one such element exists.



- 조건을 만족하는 시퀀스의 유일한 요소를 반환하거나, 해당 조건을 만족하는 요소가 없는 경우 기본값을 반환하며, 해당 조건을 만족하는 요소가 두 개 이상 존재하는 경우 에러를 발생시킵니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.singleOrDefault((x) => x === 3);

expect(result).toBe(3);





$3



- Filters a sequence of values based on a predicate.



- 조건에 따라 값을 필터링합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.where((x) => x % 2 === 0);

expect(result).toEqual([2, 4]);





$3



- Bypasses a specified number of elements in a sequence and returns the remaining elements.



- 시퀀스에서 지정된 수의 요소를 생략하고 나머지 요소를 반환합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.skip(2);

expect(result).toEqual([3, 4, 5]);





$3



- Returns a specified number of contiguous elements from the start of a sequence.



- 시퀀스의 시작부터 지정된 수의 연속적인 요소를 반환합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.take(3);

expect(result).toEqual([1, 2, 3]);





$3



- Projects each element of a sequence into a new form.



- 시퀀스의 각 요소를 새로운 형태로 변환합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.select((x) => x * 2);

expect(result).toEqual([2, 4, 6, 8, 10]);





$3



- Determines whether any element of a sequence exists or satisfies a condition.



- 시퀀스에 요소가 하나 이상 존재하는지 또는 조건을 만족하는 요소가 있는지 확인합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.any((x) => x === 3);

expect(result).toBe(true);





$3



- Returns the number of elements in a sequence.



- 시퀀스의 요소 수를 반환합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.count();

expect(result).toBe(5);



const arr = [1, 2, 3, 4, 5];

const result = arr.count((x) => x % 2 === 0);

expect(result).toBe(2);





$3



- Computes the set union of two arrays.



- 두 배열의 합집합을 반환합니다.

ts

const arr = [1, 2, 3];

const result = arr.union([3, 4, 5]);

expect([1, 2, 3].union([3, 4, 5])).toEqual([1, 2, 3, 4, 5]);



const data1 = [{ id: 1, val: "A" }, { id: 2, val: "B" }];

const data2 = [{ id: 2, val: "B" }, { id: 3, val: "C" }];

expect(data1.union(data2, x => x.id).length).toBe(3);





$3



- Returns the maximum value in the array. If a selector is provided, it returns the maximum value produced by the selector.



- 배열에서 가장 큰 값을 반환합니다. 선택자(selector)가 제공되면 해당 선택자를 통해 생성된 값들 중 최대값을 반환합니다.

ts

const arr = [1, 3, 5, 4, 2];

expect(arr.max()).toBe(5);



const dataList = [{ price: 100 }, { price: 500 }, { price: 300 }];

expect(dataList.max(now => now.price)).toBe(500);





$3



- Returns the minimum value in the array. If a selector is provided, it returns the minimum value produced by the selector.



- 배열에서 가장 작은 값을 반환합니다. 선택자(selector)가 제공되면 해당 선택자를 통해 생성된 값들 중 최소값을 반환합니다.

ts

const arr = [1, 3, 5, 4, 2];

expect(arr.min()).toBe(1);



const dataList = [{ price: 100 }, { price: 500 }, { price: 300 }];

expect(dataList.min(now => now.price)).toBe(100);





$3



- Returns the sum of all elements in the array. If a selector is provided, it returns the sum of values produced by the selector.



- 배열의 모든 요소의 합을 반환합니다. 선택자(selector)가 제공되면 해당 선택자를 통해 생성된 값들의 합을 반환합니다.

ts

const arr = [1, 2, 3, 4, 5];

expect(arr.sum()).toBe(15);



const dataList = [{ price: 100 }, { price: 500 }, { price: 300 }];

expect(dataList.sum(now => now.price)).toBe(900);





$3



- Returns the first element in the array that matches the specified predicate function. If no element matches the predicate, an error is thrown.



- 지정된 predicate 함수와 일치하는 첫 번째 요소를 반환합니다. 일치하는 요소가 없으면 오류가 발생합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.first();

expect(result).toBe(1);



const result2 = arr.first((x) => x > 3);

expect(result2).toBe(4);





$3



- Returns the first element in the array that matches the specified predicate function, or a default value if no element matches the predicate.



- 지정된 predicate 함수와 일치하는 첫 번째 요소를 반환합니다. 일치하는 요소가 없으면 기본값을 반환합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.firstOrDefault();

expect(result).toBe(1);





$3



- Returns the last element in the array that matches the specified predicate function. If no element matches the predicate, an error is thrown.



- 지정된 predicate 함수와 일치하는 마지막 요소를 반환합니다. 일치하는 요소가 없으면 오류가 발생합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.last();

expect(result).toBe(5);





$3



- Returns the last element in the array that matches the specified predicate function, or a default value if no element matches the predicate.



- 지정된 predicate 함수와 일치하는 마지막 요소를 반환합니다. 일치하는 요소가 없으면 기본값을 반환합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.lastOrDefault((x) => x % 2 === 0);

expect(result).toBe(4);





$3



- Returns an array of elements that exist in the current array but not in the other array.



- 현재 배열에서는 존재하지만 다른 배열에는 존재하지 않는 요소들의 배열을 반환합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.diff([1, 5, 6]);

expect(result).toEqual([2, 3, 4]);



const data1 = [{ id: 1 }, { id: 2 }, { id: 3 }];

const data2 = [{ id: 1 }, { id: 4 }];

expect(data1.diff(data2, x => x.id)).toEqual([{ id: 2 }, { id: 3 }]);





$3



- Returns an array of elements that exist in both the current array and the other array.



- 현재 배열과 다른 배열 모두에 존재하는 요소들의 배열을 반환합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.inter([1, 3, 5, 6]);

expect(result).toEqual([1, 3, 5]);



const data1 = [{ id: 1 }, { id: 2 }, { id: 3 }];

const data2 = [{ id: 1 }, { id: 4 }];

expect(data1.inter(data2, x => x.id)).toEqual([{ id: 1 }]);





$3



- Returns a deep copy of the current array.



- 현재 배열의 깊은 복사본을 반환합니다.



$3



- Returns a JSON string representation of the current array.



- 현재 배열의 JSON 문자열 표현을 반환합니다.



$3



- Groups the elements of an array according to a specified key selector function.



- 지정된 키 선택 함수에 따라 배열의 요소를 그룹화합니다.

ts

const arr = [{ id: 1, name: 'A' }, { id: 2, name: 'B' }, { id: 3, name: 'A' }];

expect(arr.groupBy(x => x.name)).toEqual({ 'A': [{ id: 1, name: 'A' }, { id: 3, name: 'A' }], 'B': [{ id: 2, name: 'B' }] });





$3



- Returns distinct elements from a sequence, optionally using a selector for comparison.



- 배열에서 중복 요소를 제거합니다. 선택적으로 비교를 위한 선택자(selector)를 사용할 수 있습니다.

ts

expect([1, 1, 2].distinct()).toEqual([1, 2]);



const data = [{ id: 1, val: "A" }, { id: 1, val: "B" }, { id: 2, val: "C" }];

expect(data.distinct(x => x.id)).toEqual([{ id: 1, val: "A" }, { id: 2, val: "C" }]);





$3



- Randomly shuffles the elements of an array.



- 배열의 요소를 무작위로 섞습니다.



$3



- Splits an array into chunks of a specified size.



- 배열을 지정된 크기의 덩어리로 나눕니다.

ts

expect([1, 2, 3, 4, 5].chunk(2)).toEqual([[1, 2], [3, 4], [5]]);





---



Extention Helper



Math



$3



$3



$3



A function that allows you to use decimal points for discarding/rounding/round.



I used the code of the MDN below.



https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/ceil#decimal_adjustment

ts

console.log(Math.round10(112.5345, 3)); //112.535

console.log(Math.floor10(112.5345, 3)); //112.534

console.log(Math.ceil10(112.5345, 3)); //112.535





$3



Create random numbers within that range.



(Includes maximum and minimum values.)

ts

console.log(Math.randomRange(112.5, 200, 1)); //135.1

console.log(Math.randomRange(0, 200)); //169

$3

ts

console.log(Math.clamp(10, 3, 5)); // 5

console.log(Math.clamp(1, 3, 5)); // 3

console.log(Math.clamp(4, 3, 5)); // 4





$3



- Returns the greatest common divisor of two numbers.



- 두 수의 최대공약수를 반환합니다.



$3



- Returns the greatest common divisor of an array of numbers.



- 숫자 배열의 최대공약수를 반환합니다.



$3



- Returns the least common multiple of two numbers.



- 두 수의 최소공배수를 반환합니다.



$3



- Returns the least common multiple of an array of numbers.



- 숫자 배열의 최소공배수를 반환합니다.



$3



- Performs a binary search on a sorted array.



- 정렬된 배열에서 이진 탐색을 수행합니다.



Promise



$3



- Delays the execution for a specified number of milliseconds.



- 지정된 밀리초 동안 실행을 지연시킵니다.

ts

await Promise.delay(1000);





$3



- Sets a timeout for a promise.



- 프로미스에 타임아웃을 설정합니다.

ts

await somePromise.timeout(2000, "Timed out!");

Adds a convenient prototype function package.

Getting started

Import the package to the first file you call.

``

js

import "prototype-helper";



// and use

console.log("10000".toComma()); // 10,000





Prototype Helper



Number



$3



- Returns the primitive value of a Number instance.



- Number 인스턴스의 기본값을 반환하는 메서드입니다.

ts

expect((3.141592).toNumber()).toBe(3.141592);

expect((12345).toNumber()).toBe(12345);

expect((3.14).toNumber()).toBe(3.14);





$3



- Converts a Number instance to a Decimal instance.



- Number 인스턴스를 Decimal 인스턴스로 변환하는 메서드입니다.

ts

expect((3.141592).toDecimal()).toStrictEqual(new Decimal(3.141592));

expect((12345).toDecimal()).toStrictEqual(new Decimal(12345));

expect(NaN.toDecimal().isNaN()).toBeTruthy();





$3



- Returns a string representation of a number with commas.



- 숫자를 쉼표로 구분한 문자열로 변환하는 메서드입니다.

ts

expect((3141592).toComma()).toBe("3,141,592");

expect((0).toComma()).toBe("0");

expect((-100000).toComma()).toBe("-100,000");





$3



- Calculates the modulo of a number with another number.



- 한 숫자를 다른 숫자로 나눈 나머지를 반환하는 메서드입니다.

ts

expect((7).mod(3)).toBe(1);

expect((100).mod(7)).toBe(2);





$3



- Divides a number by another number.



- 한 숫자를 다른 숫자로 나눈 결과를 반환하는 메서드입니다.

ts

expect((10).div(2)).toBe(5);

expect((8).div(3)).toBeCloseTo(2.6667, 4);





$3



- Multiplies a number by another number.



- 한 숫자에 다른 숫자를 곱한 결과를 반환하는 메서드입니다.

ts

expect((4).mul(3)).toBe(12);

expect((5).mul(0.5)).toBeCloseTo(2.5, 4);





$3



- Adds another number to a number.



- 한 숫자에 다른 숫자를 더한 결과를 반환하는 메서드입니다.

ts

expect((8).add(3)).toEqual(11);

expect((100).add(1.25)).toEqual(101.25);





$3



- Subtracts another number from a number.



- 한 숫자에서 다른 숫자를 뺀 결과를 반환하는 메서드입니다.

ts

expect((8).sub(3)).toEqual(5);

expect((100).sub(1.25)).toEqual(98.75);





$3



- Returns a string representation of an integer with fixed length.



- 정수를 지정한 자릿수만큼 0으로 채워 반환하는 메서드입니다.

ts

expect((1234).fixNumber(8)).toBe("00001234");

expect((1234).fixNumber(4)).toBe("1234");





$3



- Returns a string representation of a number with fixed decimal places.



- 소수점 이하 자릿수를 맞추어 반환하는 메서드입니다.

ts

expect((1234).fixPoint(8)).toBe("1234.00000000");

expect((1234.5678).fixPoint(2)).toBe("1234.56");





$3



- Returns the absolute value of a number.



- 숫자의 절대값을 반환하는 메서드입니다.

ts

expect((-3).abs()).toBe(3);

expect((3.14).abs()).toBe(3.14);

expect((0).abs()).toBe(0);





$3



- Checks if a number is finite.



- 숫자가 유한한지 검사하는 메서드입니다.

ts

expect((-5).isFinite()).toBe(true);

expect((1 / 0).isFinite()).toBe(false);

expect((-1 / 0).isFinite()).toBe(false);





$3



- Checks if a number is NaN.



- 숫자가 NaN인지 검사하는 메서드입니다.

ts

expect(NaN.isNaN()).toBe(true);

expect((0 / 0).isNaN()).toBe(true);

expect((-1).isNaN()).toBe(false);





$3



- Checks if a number is an integer.



- 숫자가 정수인지 검사하는 메서드입니다.

ts

expect((3).isInteger()).toBe(true);

expect((3.0).isInteger()).toBe(true);

expect((-3.1).isInteger()).toBe(false);





$3



- Adds a plus or minus symbol to a number.



- 숫자에 부호 기호를 추가하는 메서드입니다.

ts

expect((10).addSymbol()).toBe("+10");

expect((0).addSymbol()).toBe("0");

expect((-10).addSymbol()).toBe("-10");





$3



- Calculates a value from a percentage of another value.



- 다른 숫자의 백분율 값을 계산하는 메서드입니다.

ts

expect((100).percentOf(50)).toBe(50);

expect((200).percentOf(25)).toBe(50);

expect((50).percentOf(10)).toBe(5);





$3



- Calculates a percentage of a value.



- 숫자의 백분율 값을 계산하는 메서드입니다.

ts

expect((50).toPercent(100)).toBe(50);

expect((50).toPercent(200)).toBe(25);

expect((5).toPercent(50)).toBe(10);





$3



- Returns a number raised to a power.



- 숫자를 지수로 거듭제곱한 결과를 반환하는 메서드입니다.

ts

expect((10).pow(2)).toEqual(100);

expect((2).pow(10)).toEqual(1024);





$3



- Returns a number squared.



- 숫자를 제곱한 결과를 반환하는 메서드입니다.

ts

expect((2).normalize()).toEqual(4);

expect((3.1415).normalize()).toEqual(9.86902225);





$3



- Rounds a number up to the nearest integer or decimal point.



- 숫자를 가장 가까운 정수나 소수점으로 올림하는 메서드입니다.

ts

expect((3.14159).ceil()).toBe(4);

expect((3.14159).ceil(1)).toBe(3.2);

expect((1234).ceil(-2)).toBe(1300);





$3



- Returns the largest integer less than or equal to a given number.



- 주어진 숫자보다 작거나 같은 가장 큰 정수를 반환합니다.

ts

expect((3.14159).floor()).toBe(3);

expect((3.14159).floor(1)).toBe(3.1);

expect((1234).floor(-2)).toBe(1200);





$3



- Returns the value of a number rounded to the nearest integer.



- 주어진 숫자를 가장 가까운 정수로 반올림하여 반환합니다.

ts

expect((3.14159).round()).toBe(3);

expect((3.14159).round(1)).toBe(3.1);

expect((3.14159).round(3)).toBe(3.142);

expect((1234).round(-2)).toBe(1200);





$3



- Returns a human-readable file size string.



- 숫자를 읽기 쉬운 파일 크기 단위(B, KB, MB 등)로 변환합니다.

ts

expect((1024).toFileSize()).toBe("1.00KB");

expect((1048576).toFileSize()).toBe("1.00MB");





$3



- Checks if a number is between a specified range (inclusive).



- 숫자가 지정된 범위 내에 있는지 확인합니다.

ts

expect((5).isBetween(1, 10)).toBe(true);

expect((15).isBetween(1, 10)).toBe(false);





---



String



$3



- Returns a string representation of a number with fixed decimal places.



- 소수점 이하 자릿수를 맞추어 반환하는 메서드입니다.

ts

const str = "123";

const result = str.fixPoint(2);

expect(result).toEqual("123.00");





$3



- Returns a string representation of a number with fixed integer digits.



- 정수 자릿수를 맞추어 반환하는 메서드입니다.

ts

const input = "123.45";

const output = input.fixNumber(5);

expect(output).toBe("00123.45");





$3



- Returns a string with specified characters prepended to the original string.



- 문자열의 시작 부분에 주어진 문자열 또는 숫자를 주어진 길이만큼 채우는 메서드입니다.

ts

const str = "123";

const result = str.leadingChars("0", 5);

expect(result).toEqual("00123");





$3



- Returns a string representation of a number with commas separating groups of thousands.



- 숫자에 쉼표를 추가하여 반환하는 메서드입니다.

ts

expect("123".toComma()).toBe("123");

expect("1234".toComma()).toBe("1,234");

expect("12345".toComma()).toBe("12,345");





$3



- Returns the number representation of a string.



- 문자열을 숫자로 변환하여 반환하는 메서드입니다.

ts

expect("3.14".toNumber()).toBe(3.14);

expect("12345".toNumber()).toBe(12345);





$3



- Returns a string with a symbol added in front, where the symbol is "+" if the number is positive, "-" if it is negative, or an empty string if it is zero.



- 숫자에 부호를 추가하여 반환하는 메서드입니다.

ts

expect("123".addSymbol()).toBe("+123");

expect("-123".addSymbol()).toBe("-123");

expect("0".addSymbol()).toBe("0");

expect("123".addSymbol(" ")).toBe("+ 123");





$3



- Parses a JSON string and returns the resulting object.



- JSON 문자열을 파싱하여 객체로 변환하는 메서드입니다.

ts

const jsonString = '{"name": "John", "age": 30}';

const parsedObject = jsonString.fromJson(); // or fromJSON(), parseJson()

expect(parsedObject).toEqual({ name: "John", age: 30 });





$3



- Returns true if the given word exists in the string, false otherwise.



- 주어진 문자열이 해당 문자열에 포함되어 있는지 여부를 반환하는 메서드입니다.

ts

const string = "The quick brown fox jumps over the lazy dog";

expect(string.issetWord("cat")).toBe(false);





$3



- Returns a substring of the string that contains only the character at the specified index.



- 문자열에서 주어진 인덱스에 해당하는 문자를 반환하는 메서드입니다.

ts

const string = "Hello, world!";

expect(string.getChar(0)).toBe("H");

expect(string.getChar(7)).toBe("w");





$3



- Returns true if the given value is a number, false otherwise.



- 주어진 값이 숫자인지 여부를 반환하는 메서드입니다.

ts

expect("42".isNumber()).toBe(true);

expect("0xFF".isNumber()).toBe(true);

expect("()".isNumber()).toBe(false);

expect("hello".isNumber()).toBe(false);





$3



- Converts a string to camelCase.



- 문자열을 camelCase 형식으로 변환합니다.

ts

expect("hello world".toCamelCase()).toBe("helloWorld");





$3



- Converts a string to snake_case.



- 문자열을 snake_case 형식으로 변환합니다.

ts

expect("helloWorld".toSnakeCase()).toBe("hello_world");





$3



- Converts a string to kebab-case.



- 문자열을 kebab-case 형식으로 변환합니다.

ts

expect("helloWorld".toKebabCase()).toBe("hello-world");





$3



- Truncates a string to a specified length and appends a suffix.



- 문자열을 지정된 길이로 자르고 접미사를 추가합니다.

ts

expect("hello world".truncate(5)).toBe("hello...");





$3



- Capitalizes the first letter of a string.



- 문자열의 첫 글자를 대문자로 변환합니다.

ts

expect("hello".capitalize()).toBe("Hello");





Object



$3



- Returns a deep copy of the current object.



- 현재 객체의 깊은 복사본을 반환합니다.



$3



- Returns a JSON string representation of the current object.



- 현재 객체의 JSON 문자열 표현을 반환합니다.



$3



- Checks if an object is empty.



- 객체가 비어 있는지 확인합니다.

ts

expect({}._isEmpty()).toBe(true);

expect({ a: 1 }._isEmpty()).toBe(false);





$3



- Creates a new object composed of the picked object properties.



- 객체에서 특정 키만 선택하여 새로운 객체를 생성합니다.

ts

const obj = { a: 1, b: 2, c: 3 };

expect(obj._pick(["a", "c"])).toEqual({ a: 1, c: 3 });





$3



- Creates a new object composed of the properties not omitted.



- 객체에서 특정 키를 제외한 새로운 객체를 생성합니다.

ts

const obj = { a: 1, b: 2, c: 3 };

expect(obj._omit(["b"])).toEqual({ a: 1, c: 3 });





$3



- Merges the enumerable properties of one or more source objects into the target object.



- 하나 이상의 소스 객체의 열거 가능한 속성을 대상 객체로 병합합니다.



$3



- Returns an array of a given object's own enumerable string-keyed property names.



- 객체의 고유한 열거 가능한 문자열 키 속성 이름들의 배열을 반환합니다.



$3



- Returns an array of a given object's own enumerable string-keyed property values.



- 객체의 고유한 열거 가능한 문자열 키 속성 값들의 배열을 반환합니다.



$3



- Returns an array of a given object's own enumerable string-keyed property [key, value] pairs.



- 객체의 고유한 열거 가능한 문자열 키 속성의 [키, 값] 쌍들의 배열을 반환합니다.



$3



- Executes a provided function once for each object entry.



- 객체의 각 엔트리에 대해 제공된 함수를 한 번씩 실행합니다.



Array



$3



- Returns the only element of a sequence that satisfies a specified condition, and throws an error if more than one such element exists.



- 조건을 만족하는 시퀀스의 유일한 요소를 반환하며, 해당 조건을 만족하는 요소가 두 개 이상 존재하는 경우 에러를 발생시킵니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.single((x) => x === 3);

expect(result).toBe(3);





$3



- Returns the only element of a sequence that satisfies a specified condition or a default value if no such element exists, and throws an error if more than one such element exists.



- 조건을 만족하는 시퀀스의 유일한 요소를 반환하거나, 해당 조건을 만족하는 요소가 없는 경우 기본값을 반환하며, 해당 조건을 만족하는 요소가 두 개 이상 존재하는 경우 에러를 발생시킵니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.singleOrDefault((x) => x === 3);

expect(result).toBe(3);





$3



- Filters a sequence of values based on a predicate.



- 조건에 따라 값을 필터링합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.where((x) => x % 2 === 0);

expect(result).toEqual([2, 4]);





$3



- Bypasses a specified number of elements in a sequence and returns the remaining elements.



- 시퀀스에서 지정된 수의 요소를 생략하고 나머지 요소를 반환합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.skip(2);

expect(result).toEqual([3, 4, 5]);





$3



- Returns a specified number of contiguous elements from the start of a sequence.



- 시퀀스의 시작부터 지정된 수의 연속적인 요소를 반환합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.take(3);

expect(result).toEqual([1, 2, 3]);





$3



- Projects each element of a sequence into a new form.



- 시퀀스의 각 요소를 새로운 형태로 변환합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.select((x) => x * 2);

expect(result).toEqual([2, 4, 6, 8, 10]);





$3



- Determines whether any element of a sequence exists or satisfies a condition.



- 시퀀스에 요소가 하나 이상 존재하는지 또는 조건을 만족하는 요소가 있는지 확인합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.any((x) => x === 3);

expect(result).toBe(true);





$3



- Returns the number of elements in a sequence.



- 시퀀스의 요소 수를 반환합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.count();

expect(result).toBe(5);



const arr = [1, 2, 3, 4, 5];

const result = arr.count((x) => x % 2 === 0);

expect(result).toBe(2);





$3



- Computes the set union of two arrays.



- 두 배열의 합집합을 반환합니다.

ts

const arr = [1, 2, 3];

const result = arr.union([3, 4, 5]);

expect([1, 2, 3].union([3, 4, 5])).toEqual([1, 2, 3, 4, 5]);



const data1 = [{ id: 1, val: "A" }, { id: 2, val: "B" }];

const data2 = [{ id: 2, val: "B" }, { id: 3, val: "C" }];

expect(data1.union(data2, x => x.id).length).toBe(3);





$3



- Returns the maximum value in the array. If a selector is provided, it returns the maximum value produced by the selector.



- 배열에서 가장 큰 값을 반환합니다. 선택자(selector)가 제공되면 해당 선택자를 통해 생성된 값들 중 최대값을 반환합니다.

ts

const arr = [1, 3, 5, 4, 2];

expect(arr.max()).toBe(5);



const dataList = [{ price: 100 }, { price: 500 }, { price: 300 }];

expect(dataList.max(now => now.price)).toBe(500);





$3



- Returns the minimum value in the array. If a selector is provided, it returns the minimum value produced by the selector.



- 배열에서 가장 작은 값을 반환합니다. 선택자(selector)가 제공되면 해당 선택자를 통해 생성된 값들 중 최소값을 반환합니다.

ts

const arr = [1, 3, 5, 4, 2];

expect(arr.min()).toBe(1);



const dataList = [{ price: 100 }, { price: 500 }, { price: 300 }];

expect(dataList.min(now => now.price)).toBe(100);





$3



- Returns the sum of all elements in the array. If a selector is provided, it returns the sum of values produced by the selector.



- 배열의 모든 요소의 합을 반환합니다. 선택자(selector)가 제공되면 해당 선택자를 통해 생성된 값들의 합을 반환합니다.

ts

const arr = [1, 2, 3, 4, 5];

expect(arr.sum()).toBe(15);



const dataList = [{ price: 100 }, { price: 500 }, { price: 300 }];

expect(dataList.sum(now => now.price)).toBe(900);





$3



- Returns the first element in the array that matches the specified predicate function. If no element matches the predicate, an error is thrown.



- 지정된 predicate 함수와 일치하는 첫 번째 요소를 반환합니다. 일치하는 요소가 없으면 오류가 발생합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.first();

expect(result).toBe(1);



const result2 = arr.first((x) => x > 3);

expect(result2).toBe(4);





$3



- Returns the first element in the array that matches the specified predicate function, or a default value if no element matches the predicate.



- 지정된 predicate 함수와 일치하는 첫 번째 요소를 반환합니다. 일치하는 요소가 없으면 기본값을 반환합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.firstOrDefault();

expect(result).toBe(1);





$3



- Returns the last element in the array that matches the specified predicate function. If no element matches the predicate, an error is thrown.



- 지정된 predicate 함수와 일치하는 마지막 요소를 반환합니다. 일치하는 요소가 없으면 오류가 발생합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.last();

expect(result).toBe(5);





$3



- Returns the last element in the array that matches the specified predicate function, or a default value if no element matches the predicate.



- 지정된 predicate 함수와 일치하는 마지막 요소를 반환합니다. 일치하는 요소가 없으면 기본값을 반환합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.lastOrDefault((x) => x % 2 === 0);

expect(result).toBe(4);





$3



- Returns an array of elements that exist in the current array but not in the other array.



- 현재 배열에서는 존재하지만 다른 배열에는 존재하지 않는 요소들의 배열을 반환합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.diff([1, 5, 6]);

expect(result).toEqual([2, 3, 4]);



const data1 = [{ id: 1 }, { id: 2 }, { id: 3 }];

const data2 = [{ id: 1 }, { id: 4 }];

expect(data1.diff(data2, x => x.id)).toEqual([{ id: 2 }, { id: 3 }]);





$3



- Returns an array of elements that exist in both the current array and the other array.



- 현재 배열과 다른 배열 모두에 존재하는 요소들의 배열을 반환합니다.

ts

const arr = [1, 2, 3, 4, 5];

const result = arr.inter([1, 3, 5, 6]);

expect(result).toEqual([1, 3, 5]);



const data1 = [{ id: 1 }, { id: 2 }, { id: 3 }];

const data2 = [{ id: 1 }, { id: 4 }];

expect(data1.inter(data2, x => x.id)).toEqual([{ id: 1 }]);





$3



- Returns a deep copy of the current array.



- 현재 배열의 깊은 복사본을 반환합니다.



$3



- Returns a JSON string representation of the current array.



- 현재 배열의 JSON 문자열 표현을 반환합니다.



$3



- Groups the elements of an array according to a specified key selector function.



- 지정된 키 선택 함수에 따라 배열의 요소를 그룹화합니다.

ts

const arr = [{ id: 1, name: 'A' }, { id: 2, name: 'B' }, { id: 3, name: 'A' }];

expect(arr.groupBy(x => x.name)).toEqual({ 'A': [{ id: 1, name: 'A' }, { id: 3, name: 'A' }], 'B': [{ id: 2, name: 'B' }] });





$3



- Returns distinct elements from a sequence, optionally using a selector for comparison.



- 배열에서 중복 요소를 제거합니다. 선택적으로 비교를 위한 선택자(selector)를 사용할 수 있습니다.

ts

expect([1, 1, 2].distinct()).toEqual([1, 2]);



const data = [{ id: 1, val: "A" }, { id: 1, val: "B" }, { id: 2, val: "C" }];

expect(data.distinct(x => x.id)).toEqual([{ id: 1, val: "A" }, { id: 2, val: "C" }]);





$3



- Randomly shuffles the elements of an array.



- 배열의 요소를 무작위로 섞습니다.



$3



- Splits an array into chunks of a specified size.



- 배열을 지정된 크기의 덩어리로 나눕니다.

ts

expect([1, 2, 3, 4, 5].chunk(2)).toEqual([[1, 2], [3, 4], [5]]);





---



Extention Helper



Math



$3



$3



$3



A function that allows you to use decimal points for discarding/rounding/round.



I used the code of the MDN below.



https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/ceil#decimal_adjustment

ts

console.log(Math.round10(112.5345, 3)); //112.535

console.log(Math.floor10(112.5345, 3)); //112.534

console.log(Math.ceil10(112.5345, 3)); //112.535





$3



Create random numbers within that range.



(Includes maximum and minimum values.)

ts

console.log(Math.randomRange(112.5, 200, 1)); //135.1

console.log(Math.randomRange(0, 200)); //169

$3

ts

console.log(Math.clamp(10, 3, 5)); // 5

console.log(Math.clamp(1, 3, 5)); // 3

console.log(Math.clamp(4, 3, 5)); // 4





$3



- Returns the greatest common divisor of two numbers.



- 두 수의 최대공약수를 반환합니다.



$3



- Returns the greatest common divisor of an array of numbers.



- 숫자 배열의 최대공약수를 반환합니다.



$3



- Returns the least common multiple of two numbers.



- 두 수의 최소공배수를 반환합니다.



$3



- Returns the least common multiple of an array of numbers.



- 숫자 배열의 최소공배수를 반환합니다.



$3



- Performs a binary search on a sorted array.



- 정렬된 배열에서 이진 탐색을 수행합니다.



Promise



$3



- Delays the execution for a specified number of milliseconds.



- 지정된 밀리초 동안 실행을 지연시킵니다.

ts

await Promise.delay(1000);





$3



- Sets a timeout for a promise.



- 프로미스에 타임아웃을 설정합니다.

ts

await somePromise.timeout(2000, "Timed out!");