JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 1
  • Score
    100M100P100Q47763F
  • License ISC

node module wrapper for oxford dictionaries api

Package Exports

  • oxford-dictionaries-api

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (oxford-dictionaries-api) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

oxford-dictionaries-api

node module wrapper for Oxford dictionaries api v2

Install

npm install --save oxford-dictionaries-api

Usage

initial

Initialize an instance of the OxfordDictionaries class to use

// need app_id and app_key
const app_id = 'your_appid'
const app_key = 'your_appkey';

let oxford= require('oxford-dictionaries-api');
let oxforddictionaries = new oxford(app_id, app_key);

functions

Note: A lot of the key names for the functions' objects are taken from the oxford docs Here. I might not have updated this readme cause I probably would be working on other things. (I think the biggest thing that people would usually use is entries, which should get you the definition of words)

entries({ word_id, source_lang, fields, grammaticalFeatures, lexicalCategory, domains, registers, strictMatch })

function takes in an object with the following:

Key Type Optional About Default Example
word_id String No The identifier for an Entry (case-sensitive). Null "ace"
source_lang String Yes Language code of the source language in a monolingual dataset. "en-gb" "en-gb"
fields Array[String] Yes A comma-separated list of data fields to return for the matched entries Null ["definitions", "domains"]
grammaticalFeatures Array[String] Yes A comma-separated list of grammatical features ids to match on (default: all features). Null ["Cardinal", "Ordinal"]
lexicalCategory Array[String] Yes A comma-separated list of lexical categories ids to match on (default: all categories). Null
domains Array[String] Yes A comma-separated list of domains ids to match on (default: all domains). Null
registers Array[String] Yes A comma-separated list of registers ids to match on (default: all registers). Null
strictMatch Boolean Yes Specifies whether diacritics must match exactly. False True

Example:

oxforddictionaries.entries({word_id: 'ace'})
  .then((data) => console.log(data))
  .catch((e) => console.log('Error', e));

lemmas({ word_id, source_lang, grammaticalFeatures, lexicalCategory })

search({ source_lang, target_lang, q, prefix, limit, offset })

translation({ source_lang, target_lang, word_id, strictMatch })

thesaurus({ lang, word_id, fields, strictMatch })

sentences({ source_lang, word_id, strictMatch })

lexistats_ngrams({ source_lang, corpus, ngram_size, tokens, contains, format, minFrequency, maxFrequency, collate, sort, offset, limit })

lexistats_word({ source_lang, corpus, wordform, trueCase, lemma, lexicalCategory })

lexistats_words({ source_lang, corpus, wordform, trueCase, lemma, lexicalCategory, grammaticalFeatures, minFrequency, maxFrequency, minNormalizedFrequency, maxNormalizedFrequency, collate, sort, offset, limit })

domains({ source_lang, target_lang } = {})

fields({ endpoint } = {})

filters({ endpoint } = {})

grammaticalFeatures({ source_lang, target_lang } = {})

languages({ sourceLanguage, targetLanguage } = {})

lexicalcategories({ source_lang, target_lang } = {})

registers({ source_lang, target_lang } = {})