# Jisho 辞書 — Japanese word and kanji data for JavaScript

> Jisho 辞書 — Japanese word and kanji data for JavaScript: look words up by reading, written form, English meaning, a kanji in them or romaji, fetched about 25 kB at a time, safe by default or unfiltered with every sense's JMdict marks, and bring your own block and allow lists; and the grades, JLPT levels, readings and look-alikes of 2,999 kanji. Typed, no dependencies.

Install with `npm install @johnmorrisdotca/jisho`. Every page below is also an HTML page at the same address ending in .html; the documentation's home is https://johnmorrisdotca.github.io/jisho/docs/. The examples on the reference pages are run when the site is built, and what they print is shown under them.

## Guides

- [Getting started](https://johnmorrisdotca.github.io/jisho/docs/guides/getting-started.md): Install the package, look a word up, read a grade and a level, and look a kanji up.
- [Find kanji](https://johnmorrisdotca.github.io/jisho/docs/guides/find-kanji.md): Lists by grade and level, the kanji in a text, a search, and what can be mistaken for what.
- [Look up a conjugated word](https://johnmorrisdotca.github.io/jisho/docs/guides/conjugated-words.md): Find 食べなかった as 食べる, with the path negative, past: the built-in rules, the kinds of word they check, what they cover, and what they do not.
- [Example sentences](https://johnmorrisdotca.github.io/jisho/docs/guides/example-sentences.md): Fetch the sentences that show a word, each linked to the sense it shows, with furigana, English, a JLPT level and the credit each one must carry.
- [Find words by meaning](https://johnmorrisdotca.github.io/jisho/docs/guides/find-by-meaning.md): Find the commonest Japanese words whose English meaning holds a word or phrase, with findByMeaning, or search words you already have with searchMeanings.
- [The whole entry of a word](https://johnmorrisdotca.github.io/jisho/docs/guides/full-entries.md): Fetch every sense of a word with its part of speech, field, dialect, cross-references, antonyms, notes and loanword sources, and the marks of its written forms and readings.
- [Odd input and pieces that will not load](https://johnmorrisdotca.github.io/jisho/docs/guides/odd-input-and-errors.md): How a text is made plain before it is looked up, what a lookup does with input that is empty or odd, and what WordsLoadError names.
- [Read a text](https://johnmorrisdotca.github.io/jisho/docs/guides/read-text.md): Cut Japanese text into words by the longest match, with furigana, meaning, JLPT level and kanji grades for each, list what is not found, and take the words away as a study list in CSV or TSV.
- [Look words up in romaji](https://johnmorrisdotca.github.io/jisho/docs/guides/romaji.md): Read Latin letters as modified Hepburn or Kunrei romaji when looking a word up, and turn romaji into kana.
- [Stroke order, and finding a kanji by drawing it](https://johnmorrisdotca.github.io/jisho/docs/guides/stroke-order.md): Draw the stroke order of a kanji as an SVG that writes itself, and find a kanji by drawing its strokes.
- [Suggest a word when there is a typo](https://johnmorrisdotca.github.io/jisho/docs/guides/typos.md): Find the common words one slip away from what was typed in romaji or kana, for a lookup that found nothing.
- [How common a word is](https://johnmorrisdotca.github.io/jisho/docs/guides/word-rank.md): Read JMdict's priority tags and the single rank made from them, and put words in the order of commonness.
- [Look words up](https://johnmorrisdotca.github.io/jisho/docs/guides/words.md): Find a word by its reading, its written form, its English meaning, a kanji in it or romaji, choose safe or unfiltered, apply your own lists and marks, handle a piece that fails to load, and keep the dictionary out of a server's bundle.
- [Find words by a kanji](https://johnmorrisdotca.github.io/jisho/docs/guides/words-by-kanji.md): Find the commonest words written with a kanji, and link each word to the kanji table to show its grade, level, readings and meanings.
- [A plain page and a CDN](https://johnmorrisdotca.github.io/jisho/docs/guides/html-and-cdn.md): Look words up on a page with no build step, from jsDelivr or unpkg, and read the kanji table from a CDN.
- [Vite and webpack](https://johnmorrisdotca.github.io/jisho/docs/guides/bundlers.md): Use the package in a Vite or webpack project, and what the build holds.
- [React, Vue, Svelte and Angular](https://johnmorrisdotca.github.io/jisho/docs/guides/frameworks.md): Show a lookup in a component of React, Vue, Svelte or Angular, and render the words on a server.
- [TypeScript and Node](https://johnmorrisdotca.github.io/jisho/docs/guides/typescript-and-node.md): Use the package's types, and look words up in Node on a server or in a script.
- [Embed it with an iframe](https://johnmorrisdotca.github.io/jisho/docs/guides/embed-in-an-iframe.md): Put the words for a reading, a meaning or a kanji in any page with one iframe and no script.
- [How the look-alike pairs are measured](https://johnmorrisdotca.github.io/jisho/docs/guides/look-alike.md): Two published measures and one made from stroke paths, what a score means, and what they miss.
- [Where the data comes from](https://johnmorrisdotca.github.io/jisho/docs/guides/data-sources.md): The four sources, their terms, and what you must credit.
- [Architecture](https://johnmorrisdotca.github.io/jisho/docs/guides/architecture.md): How the source is laid out, and why.
- [Troubleshooting and questions](https://johnmorrisdotca.github.io/jisho/docs/guides/troubleshooting.md): Why a kanji has no level, no grade or no look-alike, and why a word has no meaning.
- [Upgrading](https://johnmorrisdotca.github.io/jisho/docs/guides/upgrading.md): What changes between versions, and what a data refresh does.

## Reference

- [@johnmorrisdotca/jisho/deinflect](https://johnmorrisdotca.github.io/jisho/docs/api/deinflect/index.md): Deinflection: the dictionary forms a conjugated word could come from, and the path from there to it.
- [@johnmorrisdotca/jisho/entries](https://johnmorrisdotca.github.io/jisho/docs/api/entries/index.md): The whole entry of a word, in an entry point of its own so that a page that looks words up never carries it.
- [@johnmorrisdotca/jisho/examples](https://johnmorrisdotca.github.io/jisho/docs/api/examples/index.md): The example sentences of a word, in an entry point of their own so that a page that looks words up never carries them.
- [@johnmorrisdotca/jisho/grades](https://johnmorrisdotca.github.io/jisho/docs/api/grades/index.md): School grades
- [@johnmorrisdotca/jisho/jlpt](https://johnmorrisdotca.github.io/jisho/docs/api/jlpt/index.md): JLPT levels, from Jonathan Waller's lists
- [@johnmorrisdotca/jisho/kanji](https://johnmorrisdotca.github.io/jisho/docs/api/kanji/index.md): Readings, meanings, strokes and ranks
- [@johnmorrisdotca/jisho/look-alike](https://johnmorrisdotca.github.io/jisho/docs/api/look-alike/index.md): Pairs of kanji that look alike
- [@johnmorrisdotca/jisho/strokes](https://johnmorrisdotca.github.io/jisho/docs/api/strokes/index.md): The stroke order of a kanji: the strokes in the order they are written, each as the SVG path KanjiVG draws it with in a square of 109 by 109, drawn as an SVG that writes itself stroke by stroke, and a search by drawing a kanji that compares the strokes as they were drawn with these.
- [@johnmorrisdotca/jisho/words](https://johnmorrisdotca.github.io/jisho/docs/api/words/index.md): Words: the Japanese words of JMdict, looked up by reading (かみ) or by written form (紙), by what they mean in English or by a kanji in them, each with a short English meaning, its senses with the marks JMdict gives them, and how common it is.
- [@johnmorrisdotca/jisho/words-common](https://johnmorrisdotca.github.io/jisho/docs/api/words-common/index.md): The common words that safe mode keeps, in one table
- [@johnmorrisdotca/jisho/words-common-extra](https://johnmorrisdotca.github.io/jisho/docs/api/words-common-extra/index.md): What to add to the common words for unfiltered mode
- [@johnmorrisdotca/jisho](https://johnmorrisdotca.github.io/jisho/docs/api/main/index.md): Jisho: Japanese kanji as data.

## Optional

- [Changelog](https://johnmorrisdotca.github.io/jisho/docs/changelog.md): every release
- [Every export, in full](https://johnmorrisdotca.github.io/jisho/llms-full.txt)
- [Source](https://github.com/johnmorrisdotca/jisho)