runtime.getURL()

Given a relative path from the manifest.json to a resource packaged with the extension, return a fully-qualified URL.

This function does not check that the resource actually exists at that URL.

Syntax

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

Parameters

path

string. A relative path from the manifest.json to a resource packaged with the extension.

Return value

string. The fully-qualified URL to the resource within the extension.

Browser compatibility

BCD tables only load in the browser

Examples

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

js
let fullURL = browser.runtime.getURL("beasts/frog.html");
console.log(fullURL);
// Returns something like:
// moz-extension://2c127fa4-62c7-7e4f-90e5-472b45eecfdc/beasts/frog.html

Example extensions

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