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


  path // string

This API is also available as browser.extension.getURL().


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


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

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

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

Example add-ons


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: Makyen, wbamberg
 Last updated by: Makyen,