🤖 Merge PR DefinitelyTyped#71871 [chrome] Allow using strings in place of chrome.enum.VALUE in offscreen and onInstalled by @fregante

Author: fregante

types/chrome/index.d.ts

@@ -6584,7 +6584,7 @@ declare namespace chrome {
         /** The parameters describing the offscreen document to create. */
         export interface CreateParameters {
             /** The reason(s) the extension is creating the offscreen document. */
-            reasons: Reason[];
+            reasons: `${Reason}`[];
             /** The (relative) URL to load in the document. */
             url: string;
             /** A developer-provided string that explains, in more detail, the need for the background context. The user agent _may_ use this in display to the user. */
@@ -8077,7 +8077,7 @@ declare namespace chrome {
             /**
              * The reason that this event is being dispatched.
              */
-            reason: OnInstalledReason;
+            reason: `${OnInstalledReason}`;
             /**
              * Optional.
              * Indicates the previous version of the extension, which has just been updated. This is present only if 'reason' is 'update'.

types/chrome/test/index.ts

@@ -967,9 +967,12 @@ function testTtsEngine() {
 
 chrome.runtime.onInstalled.addListener((details) => {
     details; // $ExpectType InstalledDetails
-    details.reason; // $ExpectType OnInstalledReason
     details.previousVersion; // $ExpectType string | undefined
+    details.reason; // $ExpectType "install" | "update" | "chrome_update" | "shared_module_update"
     details.id; // $ExpectType string | undefined
+    if (details.reason === "install") { // Accept string version of enum
+        return;
+    }
 
     // @ts-expect-error
     details.reason = "not-real-reason";
@@ -2903,7 +2906,10 @@ async function testTopSitesForPromise() {
 // https://developer.chrome.com/docs/extensions/reference/offscreen/
 async function testOffscreenDocument() {
     await chrome.offscreen.createDocument({
-        reasons: [chrome.offscreen.Reason.CLIPBOARD],
+        reasons: [
+            chrome.offscreen.Reason.CLIPBOARD,
+            "AUDIO_PLAYBACK", // Accept both enum values and strings
+        ],
         url: "https://example.com",
         justification: "Example",
     });