feat: WebContents.getOrCreateDevToolsTargetId()

[kycutler]

Background

In VS Code we are working on a CDP implementation to manage multiple WebContentsViews. We need to implement methods like getTargets that list the real targetIds of all available WebContents. Ideally we can do this synchronously and without attaching to every WebContents. But currently the only way to get the target ID of a WebContents is by attaching to it and calling e.g. Target.getTargetInfo.

Description of Change

There is an existing static method WebContents.fromDevToolsTargetId(devToolsId) that does the reverse lookup. This PR adds a method on WebContents to get the target ID directly (and synchronously).

Checklist

• PR description included
• I have built and tested this PR
• npm test passes
• tests are changed or added
• relevant API documentation, tutorials, and examples are updated and follow the documentation style guide
• PR release notes describe the change in a way relevant to app developers, and are capitalized, punctuated, and past tense.

Release Notes

Notes: Added webContents.getOrCreateDevToolsTargetId().

[codebytere]

@kycutler have you built and tested it? We don't allow PRs for which that's not true at the moment due to proliferation of poorly created AI PRs.

Thanks for sharing additional context on the feature requested, we don't have a utility to get expected target id of a webcontent without attaching.

[github-actions]

Hello @kycutler! It looks like this pull request touches one of our dependency or CI files, and per our contribution policy we do not accept these types of changes in PRs.

[deepak1556]

Implementation looks good, thanks for clarifying the use case! Still needs an api review

stale

[jkleinsc]

API LGTM

[erickzhao]

API LGTM

[release-clerk]

Release Notes Persisted

Added webContents.getOrCreateDevToolsTargetId().

[trop]

I have automatically backported this PR to "41-x-y", please check out #50176