look-upword

converts Thesaurus results from Webster API from XML to JSON.


Keywords
synonyms, thesaurus, xml, json, parts, of, speech, dictionary, api
License
ISC
Install
npm install look-upword@1.0.7

Documentation

look-upword

Converts XML data from Webster API into JSON. Words are separated by part of speech and definition.

Install

npm install --save look-upword

Getting Started

lookUpword(apiKey, queryString, suggestionCallback, wordsCallback, done)

apiKey: API key from Webster at http://www.dictionaryapi.com/

queryString: word that is being looked up

suggestionCallback: callback for when there is a typo or the word can't be found. Takes one argument which is the result JSON from Webster in the form of:

{
    word: queryString,
    related: ['related', 'words', 'in', 'an', 'array']
}

wordsCallback: callback when the word is found. Also takes one argument which is the result JSON from Webster in the for of:

{
    [
        {
            word: queryString,
            partOfSpeech: 'one of the part of speeches of the query string',
            definition: 'the definition of the query string',
            synonyms: ['some', 'of', 'the', 'synonyms'],
            related: ['words', 'that', 'are', 'related']
        },
        {
            word: queryString,
            partOfSpeech: 'another of the part of speeches of the query string',
            definition: 'another definition of the query string',
            synonyms: ['some', 'of', 'the', 'other', 'synonyms'],
            related: ['words', 'that', 'are', 'related', 'to', 'this', 'other', 'definition']
        },
    ]
}

Words can have multiple parts of speech and multiple definitions for the same part of speech! Each definition will be available in the resulting JSON.

done (optional): callback function that is called after either wordsCallback or suggestionCallback is called. (beware of suggestionCallback or wordsCallback being async)

Trying look-upword

  1. Sign up for an API key at http://www.dictionaryapi.com/

  2. Create a new directory & npm init & create index.js

mkdir look-upword-example
cd look-upword-example
npm init
touch index.js
  1. Install look-upword
npm install --save look-upword
  1. Require look-upword in your index file
var { lookUpword } = require('look-upword') (ES5)
import { lookUpword } from 'look-upword' (ES6)
  1. Write a wordsCallback and a suggestionCallback
   var wordsCallback = function (res) {
       console.log(res)
   }

   var suggestionCallback = function (res) {
       console.log(res)
   }
  1. Call the function at the bottom of the file
lookUpword('apiKey', 'word-you-want-to-look-up', wordsCallback, suggestionCallback)
  1. Then run the file
node index
  1. See output in terminal