@realeyes/environment-detector v2.0.23

Environment Detector

Installation

NPM version

$ npm i --save @realeyes/environment-detector

CDN version

The general format for the script URL is "https://codesdwncdn.realeyesit.com/environment-detector/release/{version}/environment-detector.js". You can specify which kinds of updates your app can accept using semver string in a following format:

• x.y.z to load the exact version, for example: https://codesdwncdn.realeyesit.com/environment-detector/release/1.7.2/environment-detector.js
• x.y to receive patch updates: https://codesdwncdn.realeyesit.com/environment-detector/release/1.7/environment-detector.js
• x to receive minor updates: https://codesdwncdn.realeyesit.com/environment-detector/release/1/environment-detector.js

<script src="https://codesdwncdn.realeyesit.com/environment-detector/release/1/environment-detector.js"></script>

Self hosted

To create a self-hosted solution you will need to download the library archive https://codesdwncdn.realeyesit.com/environment-detector/release/1/environment-detector.zip. The archive contains the following files:

• environment-detector.js - Detector library
• environment-detector.min.js - Minified version
• environment-detector.swf - Flash detector
• index.html - Example page
• log.gif - Tracking pixel

To use to detector you will need at least two files: environment-detector.js and environment-detector.swf. In this case you will need to provide an swf path when calling the detect() method.

<script src="https://example.com/environment-detector.js"></script>
<script>
Realeyesit.EnvironmentDetector.detect({ flash: { path: 'https://example.com/environment-detector.swf' } })
    .then(function (result) {
        // result will be an EnvironmentDetectionResult object
    });
</script>

API

The Realeyesit.EnvironmentDetector namespace contains one method: detect(). This method returns a Promise object that resolves with the EnvironmentDetectionResult object. This is the type definition for the EnvironmentDetectionResult:

{
  browser: {
    name: string,
    version: string,
  },
  platform: {
    type: string,
  },
  os: {
    name: string,
    version: string,
  },
  flash: ({
    version: string,
  }|null),
  webcams: Array.<string>,
  capabilities: Array.<string>
}

• browser.name is a string like "Chrome" or "Firefox"
• browser.version is a version string like "53.0"
• platform.type is one of "tablet", "mobile" or "desktop"
• os.name is a string like "windows" or "macos"
• os.version is a version string like "10.11"
• flash.version is a version string "\<major>.\<minor>.\<patch>.\<build>" format
• webcams is an array of strings, for example ["USB Camera", "iSight"]
• capabilities is an array of strings

Here is the list of capabilities we can detect:

{
    FLASH: 'flash',
    GET_USER_MEDIA: 'navigator.getUserMedia',
    MEDIA_RECORDER: 'MediaRecorder',
    WEBCAM: 'webcam',
    DOCUMENT_ALL: 'document.all',
    DOCUMENT_QUERY_SELECTOR: 'document.querySelector',
    HTTP: 'http',
    HTTPS: 'https',
}

The detect() method can receive an optional options object with the following type definition:

{
  flash: {
    path: string,
    testTimeout: number,
    containerId: string,
    minFlashVersion: string,
  }, // flash detection settings
  skip: Array.<string>, // you can pass an array of capabilities you don't want to check, for example ["flash"].
  logger: {
    path: string, // url of the tracking pixel
    disable: boolean, // pass true if you want to disable logging
  } // logger settings
}

Example usage

Realeyesit.EnvironmentDetector.detect()
    .then(function (result) {
        // result will be an EnvironmentDetectionResult object
    });

License

Copyright 2016 Realeyes OU.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.