困ったときと質問

学年がない

gradeOfは、常用漢字にも人名用漢字にも入っていない字にはnullを返します。問題ではありません。readKanjiには学年のある2,999字しかないので、そうした字には行もありません。

レベルがない

levelOfは、Wallerのどのリストにもない字にはnullを返します。常用漢字のうち172字はどのリストにもありません。それは難しさについて何も示しません。

似た字がない

Yenckenの二つの尺度の対象は2010年より前の常用漢字1,945字です。それ以外を補う形のスコアも、各字につき近い十字しか残していないので、2010年に加わった196字のうち9字には組がありません。形の似た漢字の測り方を見てください。

よく使う字なのに意味がない

互換漢字かもしれません。同じに見えてもコードポイントが違い、KANJIDIC2には意味がありません。"海".normalize("NFC")でよく使うほうの字になります。

単語に意味がない

JMdictにその文字列の単語がないときも、単語の語義がすべて下品、性的、配慮が必要、侮辱的とJMdictが記しているか、英訳が性や売春にふれるものだけのときも、meaningOfはnullを、wordsOfは空のリストを返します。mode: "unfiltered"を渡さない限り、単語はセーフモードで引かれ、セーフモードは除くものを取得しないからです。不具合ではありません。フィルターなしで引くと、二つを見分けられます。

活用した語が見つからない

wordsOfとloadWordsは、辞書に載っているとおりの形しか引かないので、「食べなかった」はここでは見つかりません。findInflectedを使うか、inflected: true付きで読み込んでinflectedOfで読んでください。それでも見つからないときは、対応していない形（命令形、敬語の形、「だ」を伴う名詞）か、打ち間違いかもしれません。対応している形に両方の一覧があります。

readTextが語を間違って切る、または語が見つからない

辞書にある最も長い語を、文法なしで取るので、珍しい長い語が選ばれたり、名前が見つからなかったり小さな語に分かれたり、読みが複数ある語でJMdictが最も上に置く読みになったりします（alternativesにほかの読みがあります）。セーフモードでは、モードが除く語も見つからず、その文字列はunknownに並びます。区別するにはmode: "unfiltered"で読んでください。テキストを読むを参照してください。

wordsOfが、読み込まれていないと言う

loadWordsに頼んでいない文字列に対して、wordsOfは単語なしと答える代わりに例外を投げます。単語なしと答えると、辞書にないという意味になってしまうからです。先に読み込むか、今ある単語をloadWordsにpreviousとして渡して足してください。loadCommonWordsのよく使う語の表は、どんな文字列にも答えます。

検索がWordsLoadErrorで拒否される

辞書のチャンクが、二度目の試みでも取得できませんでした。error.pieceがどのチャンクかを示し（「the readings piece 12 of 318」のような文字列）、error.causeは取得が拒否された理由です。ネットワークが切れていた、ホストがそのファイルを配信していない、バンドラーがそのチャンクをビルドから外した、といったことが考えられます。失敗は記憶されないので、もう一度頼めば、また取得を試みます。詳しくは単語を引くを参照してください。

findByMeaningで単語が見つからない

訳語に含まれる語を単位に、英語の語ごとによく使う単語20語を収めた索引から探します。JMdictが順位を付けていない単語は、最初の訳語の語でしか見つかりません。訳語によくある語を持つ単語は、その20語に入らないことがあります。訳語の中で続いている語句（go out）か、もっとまれな語で試してください。語形の変化は考慮せず（walkingで「walk」は見つかりません）、検索できるのは英語だけです。

サーバーのバンドルがとても大きくなった

バンドラーがたどる場所で@johnmorrisdotca/jisho/wordsがインポートされ、バンドラーが辞書のすべてのチャンク（約50 MB）に行き着いたのです。外し方は単語を引くにあります。