Hydrant

A generic JavaScript helper library to query and manipulate Drupal 8 via core REST

---

Setup

• Run npm i to install development dependencies.
• Run npm t to run tests and check coverage.
• Run npm run build to create a browser version; located in dist/hydrant.js.

Usage

First, ensure that you have set up cross-origin resource sharing on your Drupal site to enable Hydrant to perform necessary tasks.

From a server environment,

const Hydrant = require('hydrant');
const hydrant = new Hydrant('http://test.dev', {username: 'admin', 'password': '1234'});

hydrant.api.node.get(1)
  .then(res => {
    // res
  })
  .catch(err => {
    // err
  });

hydrant.api.query('node').condition('field_foo', 'bar').range(0, 5).get()
  .then(res => {
    // result would be first five nodes, where 'field_foo' is equal to 'bar'
  })
  .catch(err => {
    // err
  });

From the browser,

const hydrant = new window.Hydrant('http://test.dev', {username: 'admin', 'password': '1234'});

hydrant.api.node.get(1)
  .then(res => {
    // res
  })
  .catch(err => {
    // err
  });

hydrant.api.query('node').condition('field_foo', 'bar').range(0, 5).get()
  .then(res => {
    // result would be first five nodes, where 'field_foo' is equal to 'bar'
  })
  .catch(err => {
    // err
  });

Or make a bunch of requests,

const hydrant = new window.Hydrant('http://test.dev', {username: 'admin', 'password': '1234'});

Promise.all([hydrant.api.contentType.get('article'), hydrant.api.contentType.get('page'), hydrant.api.node.get(1)])
  .then(res => {
    // res
  });