PokeAPI browser wrapper, fully async with built-in cache
Switch branches/tags
Nothing to show
Clone or download
Latest commit d11f530 Sep 24, 2018
Permalink
Failed to load latest commit information.
dist quick fix Dec 19, 2017
src quick fix Dec 19, 2017
test Fixes #2 Dec 19, 2017
.gitignore initial commit Mar 11, 2017
.npmignore initial commit Mar 11, 2017
.travis.yml initial commit Mar 11, 2017
LICENSE.md initial commit Mar 11, 2017
README.md Fix Typos Sep 24, 2018
package-lock.json bump dependencies Oct 31, 2017
package.json Fixes #2 Dec 19, 2017
webpack.config.js initial commit Mar 11, 2017

README.md

pokeapi-js-wrapper

npm version Build Status Mocha browser tetst Known Vulnerabilities Ghit.me

A PokeAPI wrapper intended for browsers only. Comes fully asynchronous (with localForage) and built-in cache. For a Node (server-side) wrapper see: pokedex-promise-v2

Table of Contents

Install

Chrome Firefox Safari Opera Edge IE
8+
npm install pokeapi-js-wrapper --save

Usage

const Pokedex = require('pokeapi-js-wrapper');
const P = new Pokedex.Pokedex();
<script src="https://unpkg.com/pokeapi-js-wrapper/dist/index.js"></script>
<script> const P = new Pokedex.Pokedex(); </script>

NOTE: Any function with the designation "ByName" can also be passed an integer ID. However, the functions with the designation "ById" can only be passed an integer ID. Refer to the pokeapi v2 docs to find out more about how the data is structured.

UPDATE: You can pass an array to each function, it will retrive data for each array element. If you scroll down, you will find two examples.

Example requests

  const golduck = await P.getPokemonByName('golduck') // with await, be sure to be in an async function (and in a try/catch)
  console.log(golduck)
  
  P.getPokemonByName('eevee') // with Promise
    .then(function(response) {
      console.log(response);
    });
    
  P.resource(['/api/v2/pokemon/36', 'api/v2/berry/8', 'https://pokeapi.co/api/v2/ability/9/'])
    .then(function(response) {
      console.log(response); // resource function accepts singles or arrays of URLs/paths
    });

Configuration

Pass an Object to Pokedex() in order to configure it. Available options: protocol, hostName, versionPath, cache, timeout in ms. Any option is optional 😄. If no Object is passed, the Pokedex will be initialized to grab data from pokeapi.co using http with 20 seconds timeout and caching resources. We recommend to use HTTPS protocol since Pokeapi.co recently enabled HTTP->HTTPS redirects.

const Pokedex = require('pokeapi-js-wrapper');
const options = {
  protocol: 'https',
  hostName: 'localhost:443',
  versionPath: '/api/v2/',
  cache: true,
  timeout: 5 * 1000 // 5s
}
const P = new Pokedex.Pokedex(options);

Tests

pokeapi-js-wrapper can be tested using two strategies. One is with Node, since this package works even with Node (altough not recommended), and the other with a browser.

npm test

Or open /test/test.html in your browser. A live version can be found at gh-pages

Endpoints

Berries

Use getBerryByName to return data about a specific berry.

  P.getBerryByName('cheri')
    .then(function(response) {
      console.log(response);
    });

Use getBerryFirmnessByName to return data about the firmness of a specific berry.

  P.getBerryFirmnessByName('very-soft')
    .then(function(response) {
      console.log(response);
    });

Use getBerryFlavorByName to return data about the flavor of a specific berry.

  P.getBerryFlavorByName('spicy')
    .then(function(response) {
      console.log(response);
    });

Array as a parameter example. It can be a mixed array. This method fetches data asynchronously. So it is quite fast 😄

  P.getBerryByName(['cheri', 'chesto', 5])
    .then(function(response) {
      console.log(response);
    })
  // response will be an Array containing 3 Objects
  // response.forEach((item) => {console.log(item.size)}) // 80,50,20

Contests

Use getContestTypeByName to return data about the effects of moves when used in contests.

  P.getContestTypeByName('cool')
    .then(function(response) {
      console.log(response);
    });

Use getContestEffectById to return data about the effects of moves when used in contests.

  P.getContestEffectById(1)
    .then(function(response) {
      console.log(response);
    });

Use getSuperContestEffectById to return data about the effects of moves when used in super contests.

  P.getSuperContestEffectById(1)
    .then(function(response) {
      console.log(response);
    });

Encounters

Use getEncounterMethodByName to return data about the conditions in which a trainer may encounter a pokemon in the wild.

  P.getEncounterMethodByName("walk")
    .then(function(response) {
      console.log(response);
    });

Use getEncounterConditionByName to return data that affects which pokemon might appear in the wild.

  P.getEncounterConditionByName("swarm")
    .then(function(response) {
      console.log(response);
    });

Use getEncounterConditionValueByName to return data the various states that an encounter condition can have.

  P.getEncounterConditionValueByName("swarm-yes")
    .then(function(response) {
      console.log(response);
    });

Evolution

Use getEvolutionChainById to return data evolution chains.

  P.getEvolutionChainById(1)
    .then(function(response) {
      console.log(response);
    });

Use getEvolutionTriggerByName to return data about triggers which cause pokemon to evolve.

  P.getEvolutionTriggerByName("level-up")
    .then(function(response) {
      console.log(response);
    });

Games

Use getGenerationByName to return data about the different generations of pokemon games.

  P.getGenerationByName("generation-i")
    .then(function(response) {
      console.log(response);
    });

Use getPokedexByName to return data about specific types of pokedexes.

  P.getPokedexByName("kanto")
    .then(function(response) {
      console.log(response);
    });

Use getVersionByName to return data about specific versions of pokemon games.

  P.getVersionByName("red")
    .then(function(response) {
      console.log(response);
    });

Use getVersionGroupByName to return data about specific version groups of pokemon games.

  P.getVersionGroupByName("red-blue")
    .then(function(response) {
      console.log(response);
    });

Items

Use getItemByName to return data about specific items.

  P.getItemByName("master-ball")
    .then(function(response) {
      console.log(response);
    });

Use getItemAttributeByName to return data about specific item attribute.

  P.getItemAttributeByName("countable")
    .then(function(response) {
      console.log(response);
    });

Use getItemCategoryByName to return data about specific item category.

  P.getItemCategoryByName("stat-boosts")
    .then(function(response) {
      console.log(response);
    });

Use getItemFlingEffectByName to return data about specific item fling effect.

  P.getItemFlingEffectByName("badly-poison")
    .then(function(response) {
      console.log(response);
    });

Use getItemPocketByName to return data about specific pockets in a players bag.

  P.getItemPocketByName("misc")
    .then(function(response) {
      console.log(response);
    });

Machines

Use getMachineById to return data about specific machine.

  P.getMachineById(2)
    .then(function(response) {
      console.log(response);
    });

Moves

Use getMoveByName to return data about specific pokemon move.

  P.getMoveByName("pound")
    .then(function(response) {
      console.log(response);
    });

Use getMoveAilmentByName to return data about specific pokemon move ailment.

  P.getMoveAilmentByName("paralysis")
    .then(function(response) {
      console.log(response);
    });

Use getMoveBattleStyleByName to return data about specific pokemon move battle style.

  P.getMoveBattleStyleByName("attack")
    .then(function(response) {
      console.log(response);
    });

Use getMoveCategoryByName to return data about specific pokemon move category.

  P.getMoveCategoryByName("ailment")
    .then(function(response) {
      console.log(response);
    });

Use getMoveDamageClassByName to return data about specific pokemon damage class.

  P.getMoveDamageClassByName("status")
    .then(function(response) {
      console.log(response);
    });

Use getMoveLearnMethodByName to return data about specific pokemon learn method.

  P.getMoveLearnMethodByName("level-up")
    .then(function(response) {
      console.log(response);
    });

Use getMoveTargetByName to return data about specific pokemon move target.

  P.getMoveTargetByName("specific-move")
    .then(function(response) {
      console.log(response);
    });

Locations

Use getLocationByName to return data about specific pokemon location.

  P.getLocationByName("sinnoh")
    .then(function(response) {
      console.log(response);
    });

Use getLocationAreaByName to return data about specific pokemon location area.

  P.getLocationAreaByName("canalave-city-area")
    .then(function(response) {
      console.log(response);
    });

Use getPalParkAreaByName to return data about specific pokemon pal park area.

  P.getPalParkAreaByName("forest")
    .then(function(response) {
      console.log(response);
    });

Use getRegionByName to return data about specific pokemon region.

  P.getRegionByName("kanto")
    .then(function(response) {
      console.log(response);
    });

Pokemon

Use getAbilityByName to return data about specific pokemon ability.

  P.getAbilityByName("stench")
    .then(function(response) {
      console.log(response);
    });

Use getCharacteristicById to return data about specific pokemon characteristic.

  P.getCharacteristicById(1)
    .then(function(response) {
      console.log(response);
    });

Use getEggGroupByName to return data about specific pokemon egg group.

  P.getEggGroupByName("monster")
    .then(function(response) {
      console.log(response);
    });

Use getGenderByName to return data about specific pokemon gender.

  P.getGenderByName("female")
    .then(function(response) {
      console.log(response);
    });

Use getGrowthRateByName to return data about specific pokemon growth rate.

  P.getGrowthRateByName("slow")
    .then(function(response) {
      console.log(response);
    });

Use getNatureByName to return data about specific pokemon nature.

  P.getNatureByName("bold")
    .then(function(response) {
      console.log(response);
    });

Use getPokeathlonStatByName to return data about specific pokeathon stat.

  P.getPokeathlonStatByName("speed")
    .then(function(response) {
      console.log(response);
    });

Use getPokemonByName to return data about specific pokemon.

  P.getPokemonByName("butterfree")
    .then(function(response) {
      console.log(response);
    });

Use getPokemonColorByName to return data about specific pokemon color.

  P.getPokemonColorByName("black")
    .then(function(response) {
      console.log(response);
    });

Use getPokemonFormByName to return data about specific pokemon form.

  P.getPokemonFormByName("wormadam-plant")
    .then(function(response) {
      console.log(response);
    });

Use getPokemonHabitatByName to return data about specific pokemon habitat.

  P.getPokemonHabitatByName("grottes")
    .then(function(response) {
      console.log(response);
    });

Use getPokemonShapeByName to return data about specific pokemon shape.

  P.getPokemonShapeByName("ball")
    .then(function(response) {
      console.log(response);
    });

Use getPokemonSpeciesByName to return data about specific pokemon species.

  P.getPokemonSpeciesByName("wormadam")
    .then(function(response) {
      console.log(response);
    });

Use getStatByName to return data about specific pokemon stat.

  P.getStatByName("attack")
    .then(function(response) {
      console.log(response);
    });

Use getTypeByName to return data about specific pokemon type.

  P.getTypeByName("ground")
    .then(function(response) {
      console.log(response);
    });

Utility

Use getLanguageByName to return data about specific pokemon language.

  P.getLanguageByName("ja")
    .then(function(response) {
      console.log(response);
    });

Custom URLs and paths

Use resource to return data about any URL or path.

  P.resource(['/api/v2/pokemon/36', 'api/v2/berry/8', 'https://pokeapi.co/api/v2/ability/9/'])
    .then(function(response) {
      console.log(response); // resource function accepts singles or arrays of URLs/paths
    });

  P.resource('api/v2/berry/5')
    .then(function(response) {
      console.log(response);
    });

Root Endpoints

For each root endpoint we provide a method to get all the items contained by that endpoint. By default the method will return every item in the endpoint. If you want you can configure its offset and limit.

  • offset is where to start. The first item that you will get. Default 0
  • limit is how many items you want to list. Default 100000

TIP: Do not pass any config Object to your call, since you will get every item and everything will be cached to your RAM.

This call will get the list of pokemon between ID 35 and ID 44

  var interval = {
    limit: 10,
    offset: 34
  }
  P.getPokemonsList(interval)
    .then(function(response) {
      console.log(response);
    })

This is what you will get:

{
  "count": 811,
  "next":  "https://pokeapi.co:443/api/v2/pokemon/?limit=11&offset=44",
  "previous": "https://pokeapi.co:443/api/v2/pokemon/?limit=11&offset=22",
  "results": [
    {
      "url": "https://pokeapi.co:443/api/v2/pokemon/35/",
      "name": "clefairy"
    },
    {
      "url": "...",
      "name": "..."
    },
    {
      "url": "https://pokeapi.co:443/api/v2/pokemon/44/",
      "name": "gloom"
    }
  ]
}

List of supported root endpoints

  • .getEndpointsList()
  • .getBerriesList()
  • .getBerriesFirmnesssList()
  • .getBerriesFlavorsList()
  • .getContestTypesList()
  • .getContestEffectsList()
  • .getSuperContestEffectsList()
  • .getEncounterMethodsList()
  • .getEncounterConditionsList()
  • .getEncounterConditionValuesList()
  • .getEvolutionChainsList()
  • .getEvolutionTriggersList()
  • .getGenerationsList()
  • .getPokedexsList()
  • .getVersionsList()
  • .getVersionGroupsList()
  • .getItemsList()
  • .getItemAttributesList()
  • .getItemCategoriesList()
  • .getItemFlingEffectsList()
  • .getItemPocketsList()
  • .getMachinesList()
  • .getMovesList()
  • .getMoveAilmentsList()
  • .getMoveBattleStylesList()
  • .getMoveCategoriesList()
  • .getMoveDamageClassesList()
  • .getMoveLearnMethodsList()
  • .getMoveTar* getsList()
  • .getLocationsList()
  • .getLocationAreasList()
  • .getPalParkAreasList()
  • .getRegionsList()
  • .getAbilitiesList()
  • .getCharacteristicsList()
  • .getEggGroupsList()
  • .getGendersList()
  • .getGrowthRatesList()
  • .getNaturesList()
  • .getPokeathlonStatsList()
  • .getPokemonsList()
  • .getPokemonColorsList()
  • .getPokemonFormsList()
  • .getPokemonHabitatsList()
  • .getPokemonShapesList()
  • .getPokemonSpeciesList()
  • .getStatsList()
  • .getTypesList()
  • .getLanguagesList()

Internet Explorer 8

In order to target this browser if must load a Promise polyfill before pokeapi-js-wrapper. You can choose one of your chioce, we recommed jakearchibald/es6-promise or stefanpenner/es6-promise