index.md

---

title: runtime.getURL()
slug: Mozilla/Add-ons/WebExtensions/API/runtime/getURL
page-type: webextension-api-function
tags:
  - API
  - Add-ons
  - Extensions
  - Method
  - Non-standard
  - Reference
  - WebExtensions
  - getURL
  - runtime
browser-compat: webextensions.api.runtime.getURL

---

{{AddonSidebar()}}

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

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.

Browser compatibility

{{Compat}}

Examples

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

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

{{WebExtExamples}}

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