feat: session.setExtensionAPIHandlers for handling chrome.tabs.get and default tab requests

[sentialx]

Description of Change

This PR adds an API session.setExtensionAPIHandlers so that users can specify the behavior of the chrome.tabs.get API and the default tab behavior (for example when an extension calls chrome.tabs.getZoom without tabId it fallbacks to the active tab). The same handlers are being used for Port.sender.Tab and also for ElectronExtensionsBrowserClient::GetTabAndWindowIdForWebContents which is responsible for chrome.webRequest request details tabId property). Also adds support for chrome.tabs.insertCSS and removeCSS

This PR does not introduce any breaking changes to the API. If the handlers are not registered, chrome.tabs.get will fallback to the previous behavior and warn the user.

For example:

  ses.setExtensionAPIHandlers({
    getTab: (webContents) => {
      return {
        id: webContents.id,
        active: true,
        windowId: 1,
        highlighted: true,
        index: 1,
        groupId: 1,
        openerTabId: 0,
        discarded: false,
        autoDiscardable: true,
        pinned: true,
        mutedReason: 'user',
	    mutedExtensionId: 'sdfdsasdafadwerewrwxcvxcver',
      };
    },
    getActiveTab: (sender) => {
      // We have access to the sender WebContents, 
      // so users can for example get an active tab within the window 
      // from which the request originated.
      return webContents.fromId(selectedTabId);
    },
  });

cc @nornagon @samuelmaddock

Could this be backported to 11-x-y and 12-x-y?

Checklist

• PR description included and stakeholders cc'd
• npm test passes
• tests are changed or added
• relevant documentation is changed or added
• PR release notes describe the change in a way relevant to app developers, and are capitalized, punctuated, and past tense.

Release Notes

Notes:

• Added session.setExtensionAPIHandlers so that users can specify the behavior for chrome.tabs.get and the default tab.
• Added more properties to the Port.sender.tab.
• Added support for chrome.tabs.insertCSS and chrome.tabs.removeCSS.
• Fixed an issue where chrome.webRequest would not specify the tabId property in the request details.
• Added webContents.getExtensionTabDetails to get the Chrome API Tab representation of webContents.

[CyberFlameGO]

LGTM

[nornagon]

Re: gin::CreateHandle, it looks like our helpers weren't properly compatible. I've updated them and pushed to your branch, hope that's OK!

I also converted the callbacks to be direct values, instead of unique_ptr, since there's no particular need for the indirection.

[sentialx]

Thanks!

[nornagon]

@sentialx @samuelmaddock how are we feeling about merging this? I know it's been a while!

[sentialx]

I think everything was done here, so I guess it's okay to merge.

[samuelmaddock]

Before we merge this, I'd like to sync parts of this file from upstream to ensure the schema is up to date.

[nornagon]

API LGTM

[nornagon]

Marking as wip pending some attention from @samuelmaddock and/or @sentialx

[nornagon]

converted to draft to reflect WIP status.