web api: IExternalURLOpener

Author: joaomoreno

src/vs/workbench/browser/window.ts

@@ -141,6 +141,11 @@ export class BrowserWindow extends Disposable {
 		// will trigger the `beforeunload`.
 		this.openerService.setDefaultExternalOpener({
 			openExternal: async (href: string) => {
+				if (this.environmentService.options?.externalURLOpener) {
+					if (await this.environmentService.options?.externalURLOpener.openExternal(href)) {
+						return true;
+					}
+				}
 
 				// HTTP(s): open in new window and deal with potential popup blockers
 				if (matchesScheme(href, Schemas.http) || matchesScheme(href, Schemas.https)) {

src/vs/workbench/workbench.web.api.ts

@@ -37,6 +37,21 @@ interface IExternalUriResolver {
 	(uri: URI): Promise<URI>;
 }
 
+/**
+ * External URL opener
+ */
+interface IExternalURLOpener {
+
+	/**
+	 * Overrides the behavior when an external URL is about to be opened.
+	 * Returning false means that the URL wasn't handled, and the default
+	 * handling behavior should be used: `window.open(href, '_blank', 'noopener');`
+	 *
+	 * @returns true if URL was handled, false otherwise.
+	 */
+	openExternal(href: string): boolean | Promise<boolean>;
+}
+
 interface ITunnelProvider {
 
 	/**
@@ -363,6 +378,11 @@ interface IWorkbenchConstructionOptions {
 	 */
 	readonly resolveExternalUri?: IExternalUriResolver;
 
+	/**
+	 * Support for URL callbacks.
+	 */
+	readonly externalURLOpener?: IExternalURLOpener;
+
 	/**
 	 * A provider for supplying tunneling functionality,
 	 * such as creating tunnels and showing candidate ports to forward.
@@ -742,6 +762,9 @@ export {
 	// External Uris
 	IExternalUriResolver,
 
+	// External URL Opener
+	IExternalURLOpener,
+
 	// Tunnel
 	ITunnelProvider,
 	ITunnelFactory,