# jaco > Japanese Character Optimizer. Latest version **5.0.0** (published 2025-04-17) · MIT license · 0 weekly downloads ## Install ```sh npm install jaco pnpm add jaco yarn add jaco bun add jaco ``` ## Health **Score 30/100 (F)** — status: maintenance-mode. Positive: esm support; no vulnerabilities. Warnings: low downloads; no types. Negative: stale; low maintenance score. ## Facts | | | |---|---| | Version | 5.0.0 | | Published | 2025-04-17 | | First published | 2014-04-17 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | none | | Module format | ESM | | Dependencies | 0 | | Unpacked size | 98.5 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 79 | | Author | YusukeHirao | | Maintainers | yusukehirao | | Keywords | japanese, javascript, string, character, katakana, hiragana, unicode, surrogate pair | ## Links - npm: https://www.npmjs.com/package/jaco - Repository: https://github.com/YusukeHirao/jaco-js - Homepage: https://github.com/YusukeHirao/jaco-js#readme - Issues: https://github.com/YusukeHirao/jaco-js/issues - npm.io page: https://npm.io/package/jaco ## Alternatives - [@mce/gif](https://npm.io/package/@mce/gif.md) — 2.6K weekly downloads - [cleanse](https://npm.io/package/cleanse.md) — 173 weekly downloads - [str](https://npm.io/package/str.md) — 127 weekly downloads - [naming](https://npm.io/package/naming.md) — 95 weekly downloads - [tap-telco-api](https://npm.io/package/tap-telco-api.md) — 19 weekly downloads ## Recent versions - 5.0.0 (latest) — 2025-04-17 - 3.0.0-alpha (next) — 2019-03-04 - 4.0.0 — 2019-05-07 - 4.0.0-beta — 2019-05-07 - 4.0.0-alpha.5 — 2019-05-07 - 4.0.0-alpha.4 — 2019-05-07 - 4.0.0-alpha.3 — 2019-05-07 - 4.0.0-alpha.2 — 2019-05-07 - 4.0.0-alpha.1 — 2019-05-07 - 4.0.0-alpha — 2019-05-07 - 3.0.0 — 2019-03-05 - 2.1.0 — 2018-05-14 - 2.1.0-beta — 2017-10-11 - 2.0.0 — 2017-06-16 - 2.0.0-beta.3 — 2017-02-21 - … 15 more at https://npm.io/package/jaco/versions ## README # ![jaco](https://jaco-project.github.io/docs/jaco.png) Japanese Character Optimizer. [[English](README.md) | [日本語](README.ja.md)] [![NPM version](https://badge.fury.io/js/jaco.svg)](http://badge.fury.io/js/jaco) ## What is This module optimize Japanese characters. Convert to Katakana from Hiragana mutually, or sort list by natural phonetic order, or convert to halfwidth from fullwidth mutually. ## functions - Convert Hiragana <-> Katakana - Convert halfwidth <-> fullwidth - Check Hiragana, Katakana, halfwidth, fullwidth, and so on. - Sort by natural phonetic order. - Supported voiced marks, prolonged sound marks, iteration marks. - Has compatible native string object API. ## installation ### for NodeJS ```sh $ yarn add jaco ``` ## Usage ```js // Partial functions import toKatakana from 'jaco/toKatakana'; import toHiragana from 'jaco/toHiragana'; toKatakana('ニホンゴのモジなど'); // => ニホンゴノモジナド toHiragana('ニホンゴのモジなど'); // => にほんごのもじなど ``` ```js // Import all functions import { toKatakana, toHiragana } from 'jaco'; toKatakana('ニホンゴのモジなど'); // => ニホンゴノモジナド toHiragana('ニホンゴのモジなど'); // => にほんごのもじなど ``` ## Functions | Function | Args | Description | | ---------------------------- | ---------------------------------- | -------------------------------------------------------------- | | `addSemivoicedMarks` | str | 半濁点を追加する | | `addVoicedMarks` | str | 濁点を追加する | | `byteSize` | str | 文字列のバイトサイズを返す | | `combineSoundMarks` | str [, convertOnly] | 濁点・半濁点とひらがな・かたかなを結合させる | | `convertIterationMarks` | str | 繰り返し記号をかなに置き換える | | `convertProlongedSoundMarks` | str | 長音符をかなに置き換える | | `hasSmallLetter` | str | 小書き文字を含むかどうか | | `hasSurrogatePair` | str | サロゲートペア文字列を含んでいるかどうか | | `hasUnpairedSurrogate` | str | ペアになっていないサロゲートコードポイントを含んでいるかどうか | | `isNumeric` | str [, negative [, floatingPoint]] | 数字だけで構成されているかどうか | | `isOnly` | str, characters | 該当の文字だけで構成されているかどうか | | `isOnlyHiragana` | str | ひらがなだけで構成されているかどうか | | `isOnlyKatakana` | str | カタカナだけで構成されているかどうか | | `naturalKanaOrder` | a, b | 配列の五十音順ソートをするためのソート関数 | | `naturalKanaSort` | array | 配列の五十音順ソートをする | | `remove` | str, pattern | 文字列を取り除く | | `removeUnpairedSurrogate` | str | ペアになっていないサロゲートコードポイントの削除 | | `removeVoicedMarks` | str [, ignoreSingleMark] | 濁点・半濁点を取り除く | | `replaceFromMap` | str, convMap | キーがパターン・値が置換文字列のハッシュマップによって置換する | | `toBasicLetter` | str | 小書き文字を基底文字に変換する | | `toHiragana` | str [, isCombinate] | ひらがなに変換する | | `toKatakana` | str [, toWide] | カタカナに変換する | | `toNarrow` | str [, convertJapaneseChars] | 半角に変換 | | `toNarrowAlphanumeric` | str | 英数字を半角に変換 | | `toNarrowJapanese` | str | カタカナと日本語で使われる記号を半角に変換 | | `toNarrowKatakana` | str [, fromHiragana] | 半角カタカナに変換する | | `toNarrowSign` | str | 記号を半角に変換 | | `toNarrowSymbolForJapanese` | str | 日本語で使われる記号を半角に変換 | | `toNumeric` | str [, negative [, floatingPoint]] | 数字に変換する | | `toPhoneticKana` | str | よみの文字に変換する | | `toWide` | str | 全角に変換 | | `toWideAlphanumeric` | str | 英数字を全角に変換 | | `toWideJapanese` | str | カタカナと日本語で使われる記号を全角に変換 | | `toWideKatakana` | str | 全角カタカナに変換する | | `toWideSign` | str | 記号を全角に変換 | | `toWideSymbolForJapanese` | str | 日本語で使われる記号を全角に変換 | --- _Source: https://npm.io/package/jaco · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._