create-pmos 0.14.0 → 0.16.0

package/workspace/lib/find-browser.js

@@ -0,0 +1,60 @@
+'use strict';
+/* find-browser — locate a Chrome/Chromium this machine already has.
+ *
+ * WHY THIS EXISTS AS A MODULE. Three suites need a browser (ui-test, pm-shell-test, design-parity)
+ * and each had its own candidate list. Two of them listed only system paths — /usr/bin/chromium and
+ * the two macOS bundles — and so found nothing on a machine whose browser is the Playwright-managed
+ * one under a browsers root. What happens then is the part worth naming: the suite prints
+ * "no Chrome/Chromium — skipped" and exits 0. **A skip is indistinguishable from a pass in a CI
+ * summary**, which is how the browser assertions came to be believed without ever having run. The
+ * explainer for this surface found the same thing from the other end: ui-test.js is the only suite
+ * that measures real geometry, and it does not run in CI.
+ *
+ * So discovery is one function, it knows about the Playwright layout, and the callers report a skip
+ * as its own outcome rather than as success.
+ *
+ * NO DOWNLOAD, EVER. This finds a browser; it never fetches one. PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD is
+ * the environment's own stance and this module agrees with it: a local PM tool must not pull 150 MB
+ * off the network because a test ran.
+ */
+const fs = require('fs');
+const path = require('path');
+
+// A Playwright browsers root holds versioned directories — chromium-1194, chromium_headless_shell-1194
+// — each with the executable at a platform-specific path inside. Enumerated rather than hard-coded,
+// because the version suffix changes with every Playwright bump and a pinned one silently stops
+// matching (which is the same skip-looks-like-pass failure, arriving later).
+function playwrightCandidates() {
+  const roots = [process.env.PLAYWRIGHT_BROWSERS_PATH, '/opt/pw-browsers',
+    path.join(process.env.HOME || '', '.cache', 'ms-playwright')].filter(Boolean);
+  const out = [];
+  for (const root of roots) {
+    let entries = [];
+    try { entries = fs.readdirSync(root); } catch { continue; }
+    for (const dir of entries.sort().reverse()) {          // newest version first
+      if (!/^chromium/.test(dir)) continue;
+      out.push(
+        path.join(root, dir, 'chrome-linux', 'chrome'),
+        path.join(root, dir, 'chrome-linux', 'headless_shell'),
+        path.join(root, dir, 'chrome-mac', 'Chromium.app', 'Contents', 'MacOS', 'Chromium'),
+        path.join(root, dir, 'chrome-win', 'chrome.exe'),
+      );
+    }
+  }
+  return out;
+}
+
+function findBrowser() {
+  const cands = [
+    process.env.PMOS_CHROME,
+    process.env.PMOS_CHROMIUM,
+    ...playwrightCandidates(),
+    '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+    '/Applications/Chromium.app/Contents/MacOS/Chromium',
+    '/usr/bin/google-chrome', '/usr/bin/chromium', '/usr/bin/chromium-browser',
+    'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  ].filter(Boolean);
+  return cands.find((c) => { try { fs.accessSync(c, fs.constants.X_OK); return true; } catch { return false; } });
+}
+
+module.exports = { findBrowser, playwrightCandidates };