51Degrees Pipeline Engines

Developer Documentation

Introduction

The 51Degrees Pipeline API is a generic web request intelligence and data processing solution with the ability to add a range of 51Degrees and/or custom plug ins (Engines)

This package - fiftyone.pipeline.engines

This package extends the flow element class created by the fiftyone.pipeline.core pacakge into a specialized type of flow element called an engine. This allows for additional features including:

• An auto-updating data file for properties
• A service called when a requested property
• A caching system and implementation of an LRU (least recently used) cache

Engines created by 51Degrees:

• fiftyone.devicedetection - A device detection engine
• fiftyone.location - A geolocation lookup engine

Make use of this package along with the following additional packages:

• fiftyone.pipeline.engines.fiftyone - Functionality specific to 51Degrees engines.
• fiftyone.pipeline.cloudrequestengine - An engine used to make requests to the 51Degrees cloud service.

Installation

npm install fiftyone.pipeline.engines

Tests

To run tests you will need to install the jest library.

npm install jest --global

Then, navigate to the module directory and execute:

npm test

Examples

• examples/onPremiseFlowElement.js - Demonstrates the creation of an engine that uses an auto-updating datafile to populate properties
• examples/caching.js - Demonstrates a custom cache that makes use of the result caching feature that engines provide.