@uxbooster/utils

이 패키지는 일반적으로 사용되는 유틸리티 함수들의 모음입니다.

설치

npm install @uxbooster/utils

사용법

import { isArray, isString } from '@uxbooster/utils';

console.log(isArray([])); // true
console.log(isString('hello')); // true

함수 목록

이 패키지에서 제공하는 함수 목록은 다음과 같습니다.

함수 이름	설명	예제
intersection	두 배열 간의 교집합을 계산하는 함수.	intersection([1, 2, 3], [2, 3, 4]); // [2, 3]
not	두 배열 간의 차집합을 계산하는 함수.	not([1, 2, 3], [2, 3, 4]); // [1]
maskName	주어진 이름 문자열을 마스킹하여 반환합니다.	maskName('테이크'); // "테*크"
maskPhoneNumber	주어진 전화번호 문자열을 마스킹하여 반환합니다.	maskPhoneNumber('010-1234-5678'); // "010-****-5678"
commaizeNumber	숫자를 입력받아 3자리마다 콤마(,)를 추가한 문자열로 반환합니다.	commaizeNumber(1234567); // "1,234,567"
decommaizeNumber	콤마(,)가 포함된 문자열을 숫자로 변환합니다.	decommaizeNumber("1,234,567"); // 1234567
floorAndFormatNumber	주어진 숫자를 내림(floor) 처리하고 콤마를 포함한 형식의 문자열로 반환합니다.	floorAndFormatNumber(12345.67); // "12,345"
ceilToUnit	주어진 숫자를 올림하여 특정 단위로 포맷하는 함수입니다.	ceilToUnit(320980, 10000); // 330000
floorToUnit	주어진 숫자를 내림하여 특정 단위로 포맷하는 함수입니다.	floorToUnit(1234.56, 10); // 1230
roundToUnit	주어진 숫자를 반올림하여 특정 단위로 포맷하는 함수입니다.	roundToUnit(320980, 1000); // 321000
formatToKoreanNumber	숫자를 한글 단위로 포맷합니다.	formatToKoreanNumber(1234567); // "123만 4,567"
formatToKRW	숫자를 한글로 변환하여 원화를 포함한 포맷으로 변환하는 함수입니다.	formatToKRW(13209802); // "1,320만 9,802원"
format	문자열 내의 포맷 지정된 플레이스홀더를 대체합니다.	format('Hello, {0}!', ['John']); // 'Hello, John!'
isJsonString	주어진 문자열이 JSON 형식인지 확인합니다.	isJsonString('{ "key": "value" }'); // true
parseJson	주어진 문자열을 JSON 객체로 파싱합니다.	parseJson('{"name": "Take", "age": 3}'); // { name: 'Take', age: 3 }
replaceDynamicSegments	메뉴 URL에서 Next.js의 동적 세그먼트([param], [...param], [[...param]])를 실제 값으로 대체합니다.	replaceDynamicSegments("/post/[id]", '{"id":"123"}'); // '/post/123'
toCamelCase	문자열을 Camel case로 변환합니다.	toCamelCase('hello world'); // helloWorld
toPascalCase	문자열을 Pascal case로 변환합니다.	toPascalCase('hello world'); // HelloWorld
toRestfulFormat	문자열을 RESTful API에서 사용 가능한 형태로 변환합니다.	toRestfulFormat('hello world'); // hello-world
toSnakeCase	문자열을 스네이크 케이스로 변환합니다.	toSnakeCase('hello world'); // hello_world
copyObject	객체를 복사하여 동일한 내용을 가진 새로운 객체를 반환합니다.	copyObject({ id: 1, name: "Alice", age: 25 }); // 결과: { id: 1, name: "Alice", age: 25 }
decode	입력된 값 또는 수식을 검사해 적절한 값을 반환합니다.	decode("1", "1", "One", "2", "Two", "Default"); // 결과: "One"
formatBytes	바이트 크기를 형식화된 문자열로 변환합니다.	formatBytes(1024); // '1 KB'
generateUUID	고유한 UUID(Universally Unique Identifier)를 생성합입니다.	generateUUID(); // 'e89b9a5b-ff59-4c34-923b-7367b4a5b321'
getAge	주어진 생년월일(YYMMDD)로 만 나이를 계산합니다.	getAge("990101"); // 25 (2024년 10월 1일 기준)
getType	주어진 객체의 타입을 문자열로 반환합니다.	getType('hello'); // 'String'
isArray	주어진 값이 배열인지 확인합니다.	isArray([1, 2, 3]); // true
isBoolean	주어진 값이 부울형인지 확인합니다.	isBoolean(true); // true
isEmpty	주어진 값이 비어 있는지 확인합니다.	isEmpty(null); // true
isFunction	주어진 값이 함수인지 확인합니다.	isFunction(() => {}); // true
isInt	주어진 값이 정수인지 확인합니다.	isInt(123); // true
isMobileDevice	사용자가 모바일 기기에서 접속했는지 여부를 확인합니다.	isMobileDevice(); // true
isNull	주어진 값이 undefined 또는 null인지 확인합니다.	isNull(null); // true
isNumber	주어진 값이 숫자인지 확인합니다.	isNumber(123); // true
isObject	주어진 값이 객체인지 확인합니다.	isObject({}); // true
isString	주어진 값이 문자열인지 확인합니다.	isString('hello'); // true
isUndefined	주어진 값이 undefined인지 확인합니다.	isUndefined(undefined); // true
jwtDecode	JWT 문자열을 디코딩하여 헤더 또는 페이로드를 반환하는 함수입니다.	jwtDecode('eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c'); // { "sub": "1234567890", "name": "John Doe", "iat": 1516239022 }
nvl	주어진 값이 undefined, null, 또는 빈 문자열인 경우 대체값을 반환합니다.	nvl(undefined, 'default'); // 'default'
toBoolean	입력된 값을 boolean으로 변환합니다.	toBoolean('true'); // true
toInt	입력된 값이 숫자로 변환 가능한지 확인하고, 가능한 경우 정수로 변환합니다.	toInt('123'); // 123
toString	주어진 값의 문자열 표현을 반환합니다.	toString(123); // '123'

클래스 목록

이 패키지에서 제공하는 클래스 목록은 다음과 같습니다.

• StorageItem: 로컬 스토리지에 저장된 데이터 항목을 나타내는 클래스입니다.
• LocalStorageWorker: 브라우저의 로컬 스토리지를 사용하여 데이터를 저장하고 관리하기 위한 클래스입니다.
• CredentialStorage: 브라우저의 로컬 스토리지를 사용하여 사용자의 로그인 정보를 저장하고 관리하는 클래스입니다.