Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

es-hangul

toss54.5kMIT2.3.3TypeScript support: included

es-hangul 로고

한글, 한국어, 텍스트 처리, 초성 검색, 조사 처리, 문자 분해, 한국어 처리, hangul, korean, text processing, korean-language

readme

es-hangul 로고

es-hangul · MIT License NPM badge Discord Badge

한국어 | English

es-hangul은 쉽게 한글을 다룰 수 있도록 돕는 JavaScript 라이브러리입니다. 편리하게 사용할 수 있는 모던한 라이브러리 API를 제공합니다. ECMAScript Modules을 사용하기 때문에, 사용자가 브라우저 환경에서 최소한의 코드를 내려받도록 할 수 있습니다.

사용 예시

문자열 초성화, 조사 붙이기와 같은 한글 작업을 간단히 할 수 있습니다.

import { getChoseong } from 'es-hangul';

const searchWord = '라면';
const userInput = 'ㄹㅁ';

const result = getChoseong(searchWord); // ㄹㅁ

// 검색어의 초성과 사용자 입력 초성이 일치하는지 확인
if (result === userInput) {
  something()
}
import { josa } from 'es-hangul';

const word1 = '사과';
const sentence1 = josa(word1, '을/를') + ' 먹었습니다.';
console.log(sentence1); // '사과를 먹었습니다.'

const word2 = '바나나';
const sentence2 = josa(word2, '이/가') + ' 맛있습니다.';
console.log(sentence2); // '바나나가 맛있습니다.'

기여하기

es-hangul 라이브러리에 기여하고 싶다고 생각하셨다면 아래 문서를 참고해주세요.

CONTRIBUTING

Thanks to

한글 관련 JavaScript 생태계에 많은 기여를 해주시고, 많은 개발자들에게 영감을 주신 아래 라이브러리 오너 분들의 기여에 특별히 감사의 말씀드립니다. hangul-js: 조재민님

라이선스

MIT © Viva Republica, Inc. LICENSE 파일을 참고하세요.

<picture> <source media="(prefers-color-scheme: dark)" srcset="https://static.toss.im/logos/png/4x/logo-toss-reverse.png"> 토스 </picture>

changelog

es-hangul

2.3.3

Patch Changes

  • #333 897e355 Thanks @shren207! - feat: canBeJungseong 함수가 분리되지 않은 이중모음도 중성으로 인식하도록 개선합니다.

2.3.2

Patch Changes

2.3.1

Patch Changes

  • #324 505b947 Thanks @gunhoflash! - feat: 한글 문자를 쿼티 자판에 맞는 영문 알파벳으로 변환 하는 함수를 새로 추가합니다 합니

  • #323 2dca19c Thanks @gs18004! - fix: numberToHangulMixed 및 numberToHangul에 모든 number 처리

2.3.0

Minor Changes

  • #314 40ac51f Thanks @wet6123! - fix: numberToHangul로 큰 숫자 변환시 불필요한 단위 제거

2.2.6

Patch Changes

2.2.5

Patch Changes

  • #307 5244525 Thanks @wet6123! - feat: 숫자를 순 우리말 서수사로 변환하는 함수 추가

2.2.4

Patch Changes

2.2.3

Patch Changes

2.2.2

Patch Changes

2.2.1

Patch Changes

2.1.0

Minor Changes

  • #228 0633b9f Thanks @BO-LIKE-CHICKEN! - feat: 숫자를 날짜를 나타내는 순우리말로 바꿔주는 함수 중 days를 추가

2.0.0

Major Changes

  • #189 8a97fff Thanks @okinawaa! - feat: 문자열에서 한글을 추출해주는 extractHangul 함수를 제거합니다

  • #189 7a33c1e Thanks @okinawaa! - feat: hasBatchim 을 utils에서 별도 함수로 분리합니다.

  • #204 82e03c3 Thanks @Collection50! - fix: 일관된 한글 이름 규칙 설정 함수명에서 꼭 필요하지 않다면 hangul이라는 워딩을 제거합니다

  • #189 6456f79 Thanks @okinawaa! - feat: disassembleHangul, disassemble, disassembleHangulToGroup 함수에서 hangul이라는 글자를 제거합니다

  • #189 cbf3e4a Thanks @okinawaa! - feat: choseongIncludes함수를 제거합니다.

  • #189 7ed39ac Thanks @okinawaa! - canBeChoseong, canBeJungseong, canBeJongseong 을 utils에서 별도 함수로 분리합니다.

  • #189 642a3e4 Thanks @okinawaa! - hangulIncludes 함수를 제거합니다

  • #189 9f8dd1b Thanks @okinawaa! - feat: 한글의 두음을 반환해주는 acronymizeHangul 함수를 제거합니다.

1.5.0

Minor Changes

  • #115 84584d4 Thanks @po4tion! - feat: 한국어를 로마자로 변환해주는 함수와 한국어를 표준 발음법으로 변환해주는 함수를 만들고 문서화를 진행합니다

1.4.7

Patch Changes

  • #201 56db7f0 Thanks @BO-LIKE-CHICKEN! - feat: 숫자를 순 우리말 수사로 변환하거나 수 관형사로 변환하는 함수를 추가

1.4.6

Patch Changes

1.4.5

Patch Changes

1.4.4

Patch Changes

  • #168 e3d0259 Thanks @jungwoo3490! - fix: amountToHangul이 선행 0이 있는 문자열을 잘못 변환하는 오류를 수정합니다.

1.4.3

Patch Changes

  • #156 8a9ba36 Thanks @seungrodotlee! - fix. 겹모음과 관련하여 일부 메소드에서 잘못된 동작을 수정합니다.

1.4.2

Patch Changes

1.4.1

Patch Changes

  • #157 f7e60ae Thanks @manudeli! - fix: 패키지가 노출하는 인터페이스를 명확히 하기 위해 index.ts를 named export로 수정합니다

1.4.0

Minor Changes

1.3.10

Patch Changes

  • #148 f3c7fe9 Thanks @KNU-K! - fix : getHangulacronym함수를 acronymizeHangul 메서드로 대체합니다

1.3.9

Patch Changes

1.3.8

Patch Changes

  • #133 b0e1184 Thanks @KNU-K! - feat : 문장의 각 단어 중 첫 문자만 뽑는 extractHangul 함수를 추가합니다.

1.3.7

Patch Changes

1.3.6

Patch Changes

  • #125 a56e591 Thanks @crucifyer! - feat: 숫자로 된 금액을 국립국어원 규칙의 한글 읽기로 변환합니다.

1.3.5

Patch Changes

1.3.4

Patch Changes

1.3.3

Patch Changes

  • #90 91a46a2 Thanks @youngjae99! - feat: add convertQwertyToHangulAlphabet, disassembleCompleteHangulCha…

1.3.2

Patch Changes

  • #86 28fb57a Thanks @kangju2000! - fix: 인자로 빈 문자열이 들어올 경우 얼리리턴하도록 수정

  • #67 7c030df Thanks @BO-LIKE-CHICKEN! - fix: 초성을 뜻하는 단어를 통일

  • #83 1292575 Thanks @jungwoo3490! - fix: 호환성 개선을 위해 배열의 마지막 요소 가져오는 부분 수정

  • #75 f2b7cd9 Thanks @ssi02014! - refac: convertQwertyToHangul split 및 Non-null assertion operator 제거, 네이밍 오타 수정

1.3.1

Patch Changes

  • #68 0c784ff Thanks @99mini! - feat: 영문 알파벳을 qwerty 자판에 매칭되는 한글로 변환하는 함수 추가

1.3.0

Minor Changes

  • #64 ed33cd9 Thanks @evan-moon! - feat: 한글 문장과 문자가 담긴 배열을 인자로 받아 규칙에 맞게 합성하는 assemble 함수 추가

1.2.1

Patch Changes

1.2.0

Minor Changes

1.1.0

Minor Changes

  • #53 314f0a9 Thanks @evan-moon! - feat: 한글 자모음을 인자로 입력받아 한글 문자로 합성하는 함수 추가

1.0.9

Patch Changes

  • #36 1664575 Thanks @evan-moon! - feat: 인자로 받은 문자의 초성, 중성, 종성 위치 가능 여부를 파악하는 함수 추가 #24

1.0.8

Patch Changes

  • 73f221a: docs: nextra의 필요한 기능을 사용하고 문서를 간단명료하게 수정합니다

1.0.7

Patch Changes

  • b7df997: feat: Strictly manage constants by adding hasValueInStringList, hasPr…

1.0.6

Patch Changes

  • 5af6f19: chore: github action + changeset을 테스트하기 위함입니다.

1.0.5

Patch Changes

  • 3903d6f: chore: github action + changeset을 테스트하기 위함입니다.

1.0.4

Patch Changes

  • 571d5b0: changeset 작동을 테스트합니다