@ai-ecoverse/slicc-browsers 1.7.11 → 1.7.12

package/README.md

@@ -287,6 +287,8 @@ every alternative of an `any`, or a required (`all`, `not` or plain) check, need
 selects one variant or an array; omission selects all. `parallel` defaults to 1.
 With the `browserContexts` capability each leg runs in its own browser context. A `Target.createBrowserContext` that fails with a timeout is retried once, and the row's `notes` records it; any other failure fails the row.
 
+`settleScale` (default 1) multiplies every bound the runner waits on: settles (beacon, served, title and load), `paused`, page and child loads, the wait for a background step's `as` result (`<as> did not complete within <ms>ms`), and the wait for an observation. Adopters on slow hosts can set 3 or 4. Every wait polls and returns as soon as its event arrives, so a larger bound only costs time when something is really missing, and each timeout error names the bound it used. An observation read from the fixture (`observer: "fixture"`, such as a beacon or a served request) that the leg expects to be `true` is polled for up to 5000 ms (scaled) instead of read once. One that the leg expects to be `false` is still read once.
+
 `onStart(row)` receives each row's `id`, `target`, `variant`, `transport` and `via` as the row starts. `run()` returns a promise that also has `inFlight()`, and its result has `inFlight` too. `inFlight()` lists the rows that are running now, each as `{ id, target, variant, leg, phase, step, clients }`, where `step` is the index of the current step in its `phase` (`setup`, `trigger` or `child`), and `clients` lists each client's pending CDP calls as `{ method, session, ageMs }` (`client`, plus `unguarded` when it is a separate client). With `rowTimeoutMs`, a row still running after that many milliseconds fails on its own. Its `errors` hold `row timed out after <ms>ms: <the in-flight view>`, `inFlight` holds the view, and the clients that `clientFactory` made for it are closed. The run then goes on to the next row. It is off by default, and a client passed as `client` is never closed.
 
 `log(row)` receives completed rows. Besides `control`, `guarded`, `live`, `why` and `errors`, a row may carry `ran` (steps that ran on one leg only) and `notes` (settles skipped because their registration was refused). Both are informational: they explain a row's verdict, and adopters (bios, slicc-cli, slicc-cdp) must not count them as failures, or as passes. The verdict is `control`, `guarded` and `live`. A variant supplies the wait before an

package/guard-runner.mjs

@@ -13,6 +13,7 @@ import {
 
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 const namedResultMs = 10000;
+const observeMs = 5000;
 const q = JSON.stringify;
 const at = (value, path = '') =>
   path
@@ -115,6 +116,7 @@ class Execution {
     this.expectWhere = [...(vector.setup ?? []), ...(vector.trigger ?? [])].some(
       (step) => step.children && step.where
     );
+    this.scale = options.settleScale ?? 1;
     this.childRuns = new Map();
     this.named = new Map();
     this.processed = new Set();
@@ -167,8 +169,12 @@ class Execution {
     return out;
   }
 
+  bound(ms) {
+    return Math.round(ms * this.scale);
+  }
+
   async poll(predicate, ms = 1500) {
-    const deadline = Date.now() + ms;
+    const deadline = Date.now() + this.bound(ms);
     do {
       if (await predicate()) return true;
       await sleep(25);
@@ -513,7 +519,7 @@ class Execution {
             this.rule(event)?.url === url
         );
     if (!(await this.poll(seen, ms)) && this.side === 'control')
-      this.errors.push(`paused: no pause for ${url} within ${ms}ms`);
+      this.errors.push(`paused: no pause for ${url} within ${this.bound(ms)}ms`);
   }
 
   async answer(event) {
@@ -651,7 +657,7 @@ class Execution {
     if (refused() && !alt) return skipped();
     if (settle.variant) await sleep(this.delay);
     if (settle.title && !this.reader) {
-      await sleep(settle.ms ?? 1500);
+      await sleep(this.bound(settle.ms ?? 1500));
       return;
     }
     const met = await this.poll(async () => {
@@ -677,7 +683,7 @@ class Execution {
     if (refused() && !alt) return skipped();
     if (settle.required && !met)
       this.errors.push(
-        `settle: no ${settle.beacon ? `beacon from ${settle.beacon}` : settle.served ? `request for ${settle.served}` : settle.title ? `title ${settle.title}` : 'load'} within ${settle.ms ?? 1500}ms`
+        `settle: no ${settle.beacon ? `beacon from ${settle.beacon}` : settle.served ? `request for ${settle.served}` : settle.title ? `title ${settle.title}` : 'load'} within ${this.bound(settle.ms ?? 1500)}ms`
       );
   }
 
@@ -795,7 +801,10 @@ class Execution {
     if (!waits.length) return true;
     let timer;
     const expired = new Promise((resolve) => {
-      timer = setTimeout(() => resolve(false), this.options.namedResultMs ?? namedResultMs);
+      timer = setTimeout(
+        () => resolve(false),
+        this.bound(this.options.namedResultMs ?? namedResultMs)
+      );
     });
     const done = await Promise.race([Promise.all(waits).then(() => true), expired]);
     clearTimeout(timer);
@@ -814,11 +823,24 @@ class Execution {
       .filter((name) => typeof name === 'string' && this.named.has(name));
     if (!names.length || (await this.namedSettled(names))) return true;
     this.errors.push(
-      `${names.join(', ')} did not complete within ${this.options.namedResultMs ?? namedResultMs}ms`
+      `${names.join(', ')} did not complete within ${this.bound(this.options.namedResultMs ?? namedResultMs)}ms`
     );
     return false;
   }
 
+  async observe(name, check) {
+    const want = (this.side === 'control' ? this.vector.control.expected : this.vector.expected)?.[
+      name
+    ];
+    if (want !== true || check?.observer !== 'fixture') return this.check(check);
+    let seen = false;
+    await this.poll(async () => {
+      seen = await this.check(check);
+      return seen === true;
+    }, observeMs);
+    return seen;
+  }
+
   async check(check) {
     const c = expand(check, this.vars);
     if (!(await this.ready(c))) return false;
@@ -1022,7 +1044,7 @@ class Execution {
       for (const [name, observation] of Object.entries(this.vector.observe ?? {})) {
         if (!supported(observation.requires, this.options.capabilities)) continue;
         if ((observation.dependsOn ?? []).some((dep) => this.refused[dep])) continue;
-        observed[name] = await this.check(observation.check);
+        observed[name] = await this.observe(name, observation.check);
         if (observation.eitherWhen && this.side === 'guarded')
           observed[`${name}.either`] = await this.check(observation.eitherWhen);
       }
@@ -1391,6 +1413,11 @@ function validateBlocked(vectors) {
 
 function validate(set, opts) {
   if (!opts.fixture?.log) throw new TypeError('fixture.log is required');
+  if (
+    opts.settleScale !== undefined &&
+    !(Number.isFinite(opts.settleScale) && opts.settleScale > 0)
+  )
+    throw new TypeError('settleScale must be a positive number');
   for (const vector of set.vectors)
     for (const [name, observation] of Object.entries(vector.observe ?? {}))
       if (!observation.check) throw new TypeError(`${vector.id}: ${name} lacks a check`);

package/guard-vectors.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "setVersion": "1.7.11",
+  "setVersion": "1.7.12",
   "sources": [
     {
       "repo": "ai-ecoverse/slicc-cli",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-browsers",
-  "version": "1.7.11",
+  "version": "1.7.12",
   "description": "SLICC's shared browser catalog, JSON schemas and discovery conformance corpus",
   "type": "module",
   "license": "Apache-2.0",