extension.getURL()

Warning: This function is deprecated. Please use runtime.getURL.

Converts a relative path within an extension's install directory to a fully-qualified URL.

Syntax

js
browser.extension.getURL(
  path // string
)

Parameters

path

string. A path to a resource within an extension expressed relative to its install directory.

Return value

string. The fully-qualified URL to the resource.

Examples

Given a file packaged with the add-on at "beasts/frog.html", get the full URL like this:

js
let fullURL = browser.extension.getURL("beasts/frog.html");

// -> something like:
// moz-extension://2c127fa4-62c7-7e4f-90e5-472b45eecfdc/beasts/frog.html

Example extensions

Browser compatibility

desktop mobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
getURL
Chrome – Full support
Chrome 4 (Release date: 2010-01-25)
footnote Full support
Edge – Full support
Edge 14 (Release date: 2016-08-02)
footnote Full support
Firefox – Full support
Firefox 45 (Release date: 2016-03-08)
footnote Full support
Opera – Full support
Opera 15 (Release date: 2013-07-02)
footnote Full support
Safari – Full support
Safari 14 (Release date: 2020-09-16)
footnote Full support
Firefox for Android – Full support
Firefox for Android 48 (Release date: 2016-08-02)
footnote Full support
Safari on iOS – Full support
Safari on iOS 15 (Release date: 2021-09-20)
footnote Full support

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Note: This API is based on Chromium's chrome.extension API. This documentation is derived from extension.json in the Chromium code.