Randomorg-js NPM

Streaming Random.org JSON-RPC Javascript API - for node, command line (cli) and the browser.

Install

npm install randomorg-js
npm test

Include in html

After that you can use directly new RandomJs() class.

<script src="https://cdn.rawgit.com/tunnckoCore/randomorg-js/master/dist/randomorg-js.js"></script>

Usage in node.js

For more use-cases see the tests and examples

var RandomJs = require('randomorg-js');
var randomJs = new RandomJs();

var result = randomJs
  .apikey('6b1e65b9-4186-45c2-8981-b77a9842c4f0') // your apikey here
  .headers({'User-Agent': 'https://github.com/tunnckoCore/randomorg-js'})
  .method('generateStrings')
  .params({n:4,length:11})
  .post(function(error, stream, body) {
    console.log('==START==')
    console.log('==error==')
    console.log(error)
    console.log('==stream==')
    console.log(stream)
    console.log('==body==')
    console.log(body)
    console.log('==END==')
  });

Usage in browser

var randomJs = new RandomJs();

var result = randomJs
  .apikey('6b1e65b9-4186-45c2-8981-b77a9842c4f0') // your apikey here
  .method('generateStrings')
  .params({n:4,length:11})
  .post(function(xhr, stream, body) {
    console.log('==START==')
    console.log('==xhr==')
    console.log(xhr)
    console.log('==stream==')
    console.log(stream)
    console.log('==body==')
    console.log(body)
    console.log('==END==')
  });

API

RandomJs(body)

Initialize a new RandomJs instance with [body] (optional) object.
See also https://api.random.org/json-rpc/1/basic

members

params

[body] {Object} body object that will send to api
[statusCb] {Function} callback that recieves request status
return {RandomJs}

.request

Get status of request that will be send to API

params

[statusCb] {Function} callback that recieves request status
return {RandomJs|Object} returns self or RandomJs._request object

.apikey

Set your API key

params

<apikey> {String} your api key with that you will auth to api
[statusCb] {Function} callback that recieves request status
return {RandomJs}

.jsonrpc

Set version of Random.Org JSON RPC API

params

<value> {String} default '2.0'
[statusCb] {Function} callback that recieves request status
return {RandomJs}

.method

Set which rpc method to use (see https://api.random.org/json-rpc/1/basic)

params

<value> {String} default 'generateIntegers'
[statusCb] {Function} callback that recieves request status
return {RandomJs}

.params

Set params object that will be attached to the request body

params

<value> {Object} see defaults at index.js#L21-55, generateIntegers's defaults
[statusCb] {Function} callback that recieves request status
return {RandomJs}