大网数据广告活动
Web 标准与前端开发

WindowSharedStorage: selectURL() method

· 52CE 我爱测

The **`selectURL()`** method of the WindowSharedStorage interface executes a URL Selection operation that is registered in a module added to the current origin's SharedStorageWorklet.

Shared Storage API

The selectURL() method of the WindowSharedStorage interface executes a URL Selection operation that is registered in a module added to the current origin's SharedStorageWorklet.

[!NOTE] The URL Selection output gate is used to select a URL from a provided list to display to the user, based on shared storage data.

Syntax

selectURL(name, urls)
selectURL(name, urls, options)

Parameters

  • name
    • : A string representing the registered operation's name within the shared storage worklet module. It must match the name given to the operation when it is registered with SharedStorageWorkletGlobalScope.register().
  • urls
    • : An array of objects representing the URLs to be chosen between by the URL Selection operation. Each object contains two properties:
      • url
        • : A string representing the URL.
      • reportingMetadata
        • : An object containing properties where names are event types and values are URLs pointing to reporting destinations, for example "click" : "my-reports/report1.html". The URLs act as destinations for reports submitted with a destination of type "shared-storage-select-url", typically submitted via a Fence.reportEvent() or Fence.setReportEventDataForAutomaticBeacons() method call.
  • options
    • : An options object, which can contain the following properties:
      • data
        • : An object representing any data required for executing the operation.
      • keepAlive
        • : A boolean value. If set to true, the SharedStorageWorkletGlobalScope of the associated worklet is kept alive, and the operation can be run again. Therefore, you need to set keepAlive to true for each operation that is not intended to be the last one. The default value, false, means that the SharedStorageWorkletGlobalScope is terminated after the operation is run and cannot be run again.
      • resolveToConfig
        • : A boolean value. If set to true, the fulfillment value of the Promise returned by selectURL() will be a FencedFrameConfig object that can be used to load content into a fencedframe via its config attribute. The default value, false, means that the fulfillment value will be a URL that can be used to load content into an iframe.

Return value

A Promise that fulfills with a FencedFrameConfig object or a string representing a URL, depending on the value of the resolveToConfig option.

Exceptions

  • TypeError
    • : Thrown if:
      • The worklet module has not yet been added with Worklet.addModule.
      • urls is empty or exceeds the maximum allowed length (which is browser-specific).
      • An object's url property contains an invalid URL.
      • Shared storage is disabled (for example, via a browser setting).
      • The calling site does not have the Shared Storage API included in a successful privacy sandbox enrollment process.

Examples

Basic A/B testing

// Randomly assigns a user to a group 0 or 1
function getExperimentGroup() {
  return Math.round(Math.random());
}

async function injectContent() {
  // Add the module to the shared storage worklet
  await window.sharedStorage.worklet.addModule("ab-testing-worklet.js");

  // Assign user to a random group (0 or 1) and store it in shared storage
  window.sharedStorage.set("ab-testing-group", getExperimentGroup(), {
    ignoreIfPresent: true,
  });

  // Run the URL selection operation
  const fencedFrameConfig = await window.sharedStorage.selectURL(
    "ab-testing",
    [
      { url: `https://your-server.example/content/default-content.html` },
      { url: `https://your-server.example/content/experiment-content-a.html` },
    ],
    {
      resolveToConfig: true,
    },
  );

  // Render the chosen URL into a fenced frame
  document.getElementById("content-slot").config = fencedFrameConfig;
}

injectContent();

See the Shared Storage API landing page for a walkthrough of this example and links to other examples.

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。