Skip to content

Detects where the current browser extension code is being run. Chrome and Firefox.

License

Notifications You must be signed in to change notification settings

fregante/webext-detect

Repository files navigation

webext-detect

Detects where the current browser extension code is being run.

This package was recently renamed from webext-detect-page to webext-detect

Install

You can download the standalone bundle and include it in your manifest.json.

Or use npm:

npm install webext-detect
// This module is only offered as a ES Module
import {
	isBackgroundPage,
	isContentScript,
	isOptionsPage,
} from 'webext-detect';

Usage

import {isBackgroundPage} from 'webext-detect';

if (isBackgroundPage()) {
	// Run background code, e.g.
	browser.runtime.onMessage.addListener(console.log);
} else if (isContentScript()) {
	// Run content script code, e.g.
	browser.runtime.sendMessage('wow!');
}

API

The functions are only ever evaluated once. This protects from future "invalidated context" errors. Read the note about testing if you're running this code in a tester.

isWebPage()

Returns a boolean that indicates whether the code is being run on http(s):// pages (it could be in a content script or regular web context).

isExtensionContext()

Returns a boolean that indicates whether the code is being run in extension contexts that have access to the chrome API.

isBackground()

Returns a boolean that indicates whether the code is being run in a background page or background worker.

isBackgroundPage()

Returns a boolean that indicates whether the code is being run in a background page (manifest v2).

isBackgroundWorker()

Returns a boolean that indicates whether the code is being run in a background worker (manifest v3).

isContentScript()

Returns a boolean that indicates whether the code is being run in a content script.

isOptionsPage()

Returns a boolean that indicates whether the code is being run in an options page. This only works if the current page’s URL matches the one specified in the extension's manifest.json.

isDevToolsPage()

Returns a boolean that indicates whether the code is being run in a dev tools page. This only works if the current page’s URL matches the one specified in the extension's manifest.json devtools_page field.

isChrome()

isFirefox()

isSafari()

isMobileSafari()

Returns a boolean if it matches the current browser. They are loose detections based on the user agent that are useful when developing Web Extensions.

getContextName()

Returns the first matching context among those defined in index.ts, depending on the current context:

  • 'contentScript'
  • 'background'
  • 'options'
  • 'devToolsPage'
  • 'extension'
  • 'web'
  • 'unknown'

Testing

The calls are automatically cached so, if you're using this in a test environment, import and call this function first to ensure that the environment is "detected" every time:

import {disableWebextDetectPageCache} from 'webext-detect';
disableWebextDetectPageCache();

Related

License

MIT © Federico Brigante

About

Detects where the current browser extension code is being run. Chrome and Firefox.

Resources

License

Stars

Watchers

Forks

Packages

No packages published