Skip to content

djsegal/ember-browser-checker

Repository files navigation

Ember Observer Score

ember-browser-checker

Browser detector using browser features, not navigator.userAgent

Compatibility

  • Ember.js v3.12 or above
  • Ember CLI v2.13 or above
  • Node.js v10 or above

Installation

ember install ember-browser-checker

Usage

Check what browser is being used with ease. For example:

  • Print a special message for safari:
{{#if (is-safari)}}
  I'm on a safari!
{{/if}}
  • Get the name of the user's browser:
You are on {{browser-name}}.
  • Inject the browserChecker service and use everywhere else
import { inject as service } from '@ember/service';

...
@service browserChecker;

this.browserChecker.isBlink
this.browserChecker.isChrome
this.browserChecker.isEdge
this.browserChecker.isEdgeChromium
this.browserChecker.isExplorer
this.browserChecker.isFirefox
this.browserChecker.isOpera
this.browserChecker.isSafari

Browsers detected

Browser Helper {{browser-name}} Detects
Blink is-blink n/a *
Chrome is-chrome chrome 1.0+
Edge is-edge edge 20+
EdgeChromium is-edge-chromium edgeChromium all
Explorer is-explorer explorer 6-11
Firefox is-firefox firefox 1.0+
Opera is-opera opera 8.0+
Safari is-safari safari 3.0+

* Blink is the rendering engine used by multiple browsers (Chrome, Microsoft Edge (chromium), Opera) so blink is not returned by the helper

Template linting errors

In Ember Octane (v3.15+), non-builtin helpers will generate linting errors for the following rules: no-curly-component-invocation and no-implict-this.

To disable these errors, you need to allow the helpers in the .template-lintrc.js file located in the project root. Example entries for the browser helpers is below:

'use strict';

module.exports = {
  extends: 'octane',
  rules: {
    'no-curly-component-invocation': {
      allow: [
        'browser-name',
        'is-blink',
        ...
      ]
    },
    'no-implicit-this': {
      allow: [
        'browser-name',
        'is-blink',
        ...
      ]
    }
  }
};

Contributing

See the Contributing guide for details.

License

This project is licensed under the MIT License.