getAllNames

INFO

houki-abbreviations v0.7.1 の dist/index.d.ts と specs/current/get_all_names/spec.md から自動生成しました（仕様 ID 10 件・2026-10-10）。手で編集しないでください。再生成は node scripts/generate-reference.mjs です。

関数・ v0.5.0 で追加・ family では未使用

abbr / formal / aliases のいずれかから、そのエントリの 全別表記 を文字列配列で返す。

順序は [abbr, formal, ...aliases]、重複は除去済み。 options.normalize が true のとき、全角英数字・ダッシュ類・全角チルダ・全角スペースを半角にしてから比べる（v0.7.0 から）。返す名前は辞書の表記のまま。既定は false。

利用者と得られる結果

この関数の利用者と、利用者が渡すもの・得られる結果を示します。

houki-abbreviations を import する利用者（houki-egov-mcp・houki-nta-mcp などの MCP サーバー、またはアプリケーション）。法令・通達の名前を 1 つ渡して、同じ法令・通達を指す名前（略称・正式名称・別名）の一覧を受け取る。LLM のプロンプトに「この法令はこれらの名前でも呼ばれる」と書くときに使う

シグネチャ

import して呼ぶときの形です。パッケージの型定義（dist/index.d.ts）から写しています。

function getAllNames(name: string, options?: GetAllNamesOptions): string[];

引数	説明
`name`	略称・正式名・別名のいずれか
`options`	照合オプション（省略可）

関係する型: GetAllNamesOptions

例

型定義の JSDoc に書かれている例です。

例

import { getAllNames } from '@shuji-bonji/houki-abbreviations';

getAllNames('消法');
// → ['消法', '消費税法', '消費税', 'インボイス', 'インボイス制度', ...]

getAllNames('ＰＬ法', { normalize: true });
// → ['製造物責任法', 'PL法']（v0.7.0 から。normalize なしなら []）

getAllNames('存在しない');
// → []

扱わないこと

この関数が意図して扱わないことです。

部分一致やあいまい一致で探すこと（完全一致だけ。部分一致は searchByName、似た名前の候補は findSimilar / suggestCorrection）
エントリそのもの（law_id・domain など）を返すこと（resolveAbbreviation）
e-Gov の法令 ID や法令番号から名前を引くこと（lookupByLawId / lookupByLawNum でエントリを引いてから、その abbr を渡す）
1 回の呼び出しで複数の名前を引くこと

処理の流れ

仕様書の「処理の流れ」の節を、図も含めてそのまま写しています。図が大きいので畳んでいます。

処理の流れの図（仕様書の写し）

図の中の番号は「できること」の仕様 ID の末尾 3 桁です。

仕様項目の一覧

この関数の仕様項目 10 件の見出しです。仕様項目は受入テストと 1 対 1 で対応していて、条件と例は仕様書ページで読めます。

仕様項目の見出し（10 件）

仕様 ID	仕様項目
001	略称からそのエントリの名前を abbr・formal・aliases の順ですべて返す
002	正式名称や別名から引いても略称から引いたときと同じ配列を返す
003	別名の無いエントリには abbr と formal だけを返す
004	一致するエントリが無ければ空配列を返す
005	空文字・空白だけの name には空配列を返す
006	同じ文字列の名前は最初の 1 つだけを返す
007	name の前後の空白を除いてから引く
008	呼ぶたびに新しい配列を返す
009	normalize: true では全角英数字・ダッシュ類を半角にしてから引く
010	normalize を省くか false にすると全角と半角を別の文字として引く

getAllNames ​

利用者と得られる結果 ​

シグネチャ ​

例 ​

扱わないこと ​

処理の流れ ​

仕様項目の一覧 ​

関連ページ ​