extension.getURL()

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

Syntax

browser.extension.getURL(
  path // string
)

Parameters

path
string. A path to a resource within an add-on expressed relative to its install directory.

Return value

string. The fully-qualified URL to the resource.

Browser compatibility

Chrome Edge Firefox Firefox for Android Opera
Basic support Yes Yes 45.0 48.0 33

Examples

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

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

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

Example add-ons

Acknowledgements

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

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

Document Tags and Contributors

 Contributors to this page: wbamberg, Makyen
 Last updated by: wbamberg,