Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including vexdb with all npm packages installed. Try it out:

var vexdb = require("vexdb")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

vexdb v3.1.1

A simple tool for accessing the VexDB


Build Status codecov npm

vexdb is a wrapper for VexDB.



Install this package with yarn:

yarn add vexdb

or, if you want to use npm:

npm i vexdb

API Primer


Retrieves data from an endpoint with the specified parameters. These parameters can include any that can be specified to VexDB, as well as final values in the response object.

Normally, vexdb limits responses to 5000 items per request. vexdb will make enough requests to ensure that all applicable matches are returned

// Get all events in StarStruck
var vexdb = require("vexdb");
vexdb.get("events", { season: "StarStruck" }).then(console.log);

// Get all teams from California
  .get("teams", {
    region: "California",


This works basically identically to .get(), but returns the number of items that fit this result.

// Get the number of all teams in California
vexdb.size("teams", { region: "California" }).then(console.log);

// All examples from .get() above would work here...

Depending on the parameters specified, size() may or may not send nodata requests. In order to minimize bandwidth, you'll want to only include parameters that can be passed directly to VexDB


In many cases, you'll want to share headers and parameters across requests. This can be done using vexdb.constants.header and vexdb.constants.param, respectively:

  region: "California",

  "User-Agent": "<custom user agent string>",

Warning: Because of the Cross Origin Policy, setting headers using vexdb.constants.header may cause the browser to automatically block requests to It is not reccomended to use headers in the browser.


Since VexDB only updates every 4 minutes, this module will prevent repeat requests by resolving them with the previous value immediately. You can control this behavior with vexdb.cache

Note: vexdb uses my own keya module to handle cache. In Node, caching will take place using sqlite, while in the browser, caches will be stored first in IndexedDB

Update the Time To Live for new caches

vexdb.cache.setTTL(60 * 1000);

See if a cache is present

  .has("teams", {
    region: "South Carolina",
  .then(console.log); // Boolean

Directly resolve a cached value

vexdb.cache.resolve("skills", { region: "Utah" }).then(console.log); // The resolved value, or undefined if the cache isn't present

Clear the cache

vexdb.cache.clear().then(() => console.log("Cache has been cleared"));


This module also supports basic live features. Specify an endpoint and parameters (passed through to get()) and recieve updates on new items that fit that criteria

  .live("matches", {
    scored: 1,
    sku: "RE-VRC-17-3805",
  .on("item", console.log);

Note that the item event will trigger for every result on the inital poll. This means that every item that fits the parameters will be passed to item. If you do not want this to be the case, specify prefetch: true in your listed parameters

// Only new matches will trigger item
  .live("matches", {
    scored: 1,
    sku: "RE-VRC-17-3805",
    prefetch: true,
  .on("item", console.log);



  • newItems Object[]

Emitted on a successful fetch


  • results Object[]

Emitted when a prefetch has been completed


  • item Object

Emitted for each new item


Emitted for each new item


close(): undefined Stop new polls

params(newParams: Object): Object Override request parameters for future requests. Note: this does not change the current index of results

current(): Object[] Returns the current cache of results

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free