ember-browser-checker

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.