Skip to content

AndyMender/jisho-js

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

jisho-js

Simple JavaScript wrapper around the jisho.org search Web API.

Build Status

Details

The library provides functions to query words directly through the exposed 'Search' API endpoint, with different possible crateria, such as

  • JLPT levels

  • WaniKani levels

  • Word commonality

  • Additional filter tags like #wasei to search for wasei eigo (和製英語) words

Unlike some other existing JavaScript implementations, it does not scrape the HTML output of returned results. The downside is that many keywords supported by the https://jisho.org website do not work.

Limitations

  • Many filter flags mentioned in the docs are not supported by the officially exposed Web API, however some obvious combinations don't work in the Web UI either (for instance, the #adjective tag often returns non-adjective words for a given query).

  • Kanji results are not supported by the Web API, however these would likely require separate handling due to their nature (for instance, kanji consist of radicals/parts)

  • The Web API always returns HTTP 200 even when the response is empty or the input was not correctly formatted. As a result, additional error handling needs to be done in the JS API layer or even in possible client code.

About

JavaScript client for the jisho.org search Web API

Resources

License

Stars

Watchers

Forks

Packages

No packages published