Add controlled-frame

[browser-specs-bot]

URL

https://wicg.github.io/controlled-frame/

Rationale

• See repository: WICG/controlled-frame
• Would-be shortname: controlled-frame

Additional properties

{}

[browser-specs-bot]

Changes to index.json

This update would trigger the following changes in index.json:

Add spec (1)

{
  "url": "https://wicg.github.io/controlled-frame/",
  "seriesComposition": "full",
  "shortname": "controlled-frame",
  "series": {
    "shortname": "controlled-frame",
    "currentSpecification": "controlled-frame",
    "title": "Controlled Frame API",
    "shortTitle": "Controlled Frame API",
    "nightlyUrl": "https://wicg.github.io/controlled-frame/"
  },
  "organization": "W3C",
  "groups": [
    {
      "name": "Web Platform Incubator Community Group",
      "url": "https://www.w3.org/community/wicg/"
    }
  ],
  "nightly": {
    "url": "https://wicg.github.io/controlled-frame/",
    "status": "Draft Community Group Report",
    "alternateUrls": [],
    "repository": "https://github.com/WICG/controlled-frame",
    "sourcePath": "index.bs",
    "filename": "index.html"
  },
  "title": "Controlled Frame API",
  "source": "spec",
  "shortTitle": "Controlled Frame API",
  "categories": [
    "browser"
  ],
  "standing": "good"
}

Tests

These changes look good! 😎

Crawl results for Controlled Frame API

Crawl summary:

• Title: Controlled Frame API
• Authoring tool: bikeshed
• Date: 29 March 2025
• Revision ID: 3816617e802bac187136b2494c22478f5e41e228
• Canonical URL: https://wicg.github.io/controlled-frame/
• Spec defines:
  • Algorithms: 113 found
  • Events: 12 found
  • Headings: 64 found
  • IDs: 3022 found
  • Links: 42 rawlinks, 45 autolinks
  • References: 23 normative, 4 informative
  • Terms: 16 explicitly exported, 435 exported by default, 71 private
  • Web IDL: 92 names (or partials)
• No CDDL, CSS definitions found

92 Web IDL names

• interface HTMLControlledFrameElement (xref search)
• dictionary InjectDetails (xref search)
• dictionary InjectionItems (xref search)
• enum RunAt (xref search)
• dictionary ContentScriptDetails (xref search)
• dictionary ClearDataOptions (xref search)
• dictionary ClearDataTypeSet (xref search)
• enum ZoomMode (xref search)
• dictionary ImageDetails (xref search)
• interface ConsoleMessage (xref search)
• interface ConsoleMessageEvent (xref search)
• dictionary ConsoleMessageEventInit (xref search)
• enum DialogType (xref search)
• interface DialogController (xref search)
• interface DialogMessage (xref search)
• interface DialogEvent (xref search)
• dictionary DialogEventInit (xref search)
• enum WindowOpenDisposition (xref search)
• interface NewWindowController (xref search)
• interface NewWindow (xref search)
• interface NewWindowEvent (xref search)
• dictionary NewWindowEventInit (xref search)
• enum PermissionType (xref search)
• interface PermissionRequestControllerBase (xref search)
• interface MediaPermissionRequestController (xref search)
• interface GeolocationPermissionRequestController (xref search)
• interface PointerLockPermissionRequestController (xref search)
• interface DownloadPermissionRequestController (xref search)
• interface FileSystemPermissionRequestController (xref search)
• interface FullscreenPermissionRequestController (xref search)
• interface HidPermissionRequestController (xref search)
• interface PermissionRequest (xref search)
• interface PermissionRequestEvent (xref search)
• dictionary PermissionRequestEventInit (xref search)
• interface SizeChange (xref search)
• interface SizeChangedEvent (xref search)
• dictionary SizeChangedEventInit (xref search)
• interface ZoomChange (xref search)
• interface ZoomChangeEvent (xref search)
• dictionary ZoomChangeEventInit (xref search)
• interface ContentLoadEvent (xref search)
• dictionary ContentLoadEventInit (xref search)
• interface LoadInfo (xref search)
• interface LoadAbortInfo (xref search)
• interface LoadRedirectInfo (xref search)
• interface LoadAbortEvent (xref search)
• dictionary LoadAbortEventInit (xref search)
• interface LoadCommitEvent (xref search)
• dictionary LoadCommitEventInit (xref search)
• interface LoadStartEvent (xref search)
• dictionary LoadStartEventInit (xref search)
• interface LoadStopEvent (xref search)
• dictionary LoadStopEventInit (xref search)
• interface LoadRedirectEvent (xref search)
• dictionary LoadRedirectEventInit (xref search)
• enum ResourceType (xref search)
• callback interface WebRequestEventListener (xref search)
• dictionary RequestFilter (xref search)
• enum ExtraInfoSpec (xref search)
• interface WebRequestEvent (xref search)
• dictionary WebRequestAuthCredentials (xref search)
• dictionary BlockingResponse (xref search)
• enum DocumentLifecycle (xref search)
• enum FrameType (xref search)
• dictionary WebRequestEventDetails (xref search)
• dictionary UploadData (xref search)
• dictionary RequestBody (xref search)
• dictionary WebRequestBeforeRequestDetails (xref search)
• dictionary HttpHeader (xref search)
• dictionary WebRequestBeforeSendHeadersDetails (xref search)
• dictionary WebRequestSendHeadersDetails (xref search)
• dictionary WebRequestResponseEventDetails (xref search)
• dictionary WebRequestHeadersReceivedDetails (xref search)
• dictionary AuthChallenger (xref search)
• dictionary WebRequestAuthRequiredDetails (xref search)
• dictionary WebRequestResponseWithIpEventDetails (xref search)
• dictionary WebRequestBeforeRedirectDetails (xref search)
• dictionary WebRequestResponseStartedDetails (xref search)
• dictionary WebRequestCompletedDetails (xref search)
• dictionary WebRequestErrorOccurredDetails (xref search)
• callback HandlerBehaviorChangedCallback (xref search)
• interface WebRequest (xref search)
• enum ContextType (xref search)
• enum ItemType (xref search)
• dictionary OnClickData (xref search)
• callback ContextMenusCallback (xref search)
• interface ContextMenusEvent (xref search)
• interface OnClickedEvent (xref search)
• interface OnShowEvent (xref search)
• dictionary ContextMenusProperties (xref search)
• dictionary ContextMenusCreateProperties (xref search)
• interface ContextMenus (xref search)

16 explicitly exported terms

• pendingFetchCount for "content script config", type dfn (xref search)
• js for "content script config", type dfn (xref search)
• css for "content script config", type dfn (xref search)
• matches for "content script config", type dfn (xref search)
• excludeMatches for "content script config", type dfn (xref search)
• allFrames for "content script config", type dfn (xref search)
• matchAboutBlank for "content script config", type dfn (xref search)
• runAt for "content script config", type dfn (xref search)
• WebRequest handler config, type dfn (xref search)
• handler for "WebRequest handler config", type dfn (xref search)
• filter for "WebRequest handler config", type dfn (xref search)
• requestsBody for "WebRequest handler config", type dfn (xref search)
• requestsHeaders for "WebRequest handler config", type dfn (xref search)
• requestsAllHeaders for "WebRequest handler config", type dfn (xref search)
• blocking for "WebRequest handler config", type dfn (xref search)
• asyncBlocking for "WebRequest handler config", type dfn (xref search)

[dontcallmedom]

limited to IWA, shipping since Chrome 138 according to https://chromestatus.com/feature/5199572022853632

I wonder if we should start an IWA spec category while the relationship with IWA and non-Chrome browsers remains open?

[github-actions]

The specification was updated on 2025-04-30 (last reviewed on 2025-04-22).