@stacksjs/testing 0.75.305 → 0.75.308
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/browser.d.ts +4 -0
- package/dist/browser.js +6 -6
- package/package.json +11 -11
package/dist/browser.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import process from 'node:process';
|
|
1
2
|
/**
|
|
2
3
|
* Poll `read` until it returns something truthy, and return that. Throws
|
|
3
4
|
* after `timeoutMs` (default 12 s) with `label` in the message.
|
|
@@ -152,6 +153,8 @@ export declare interface ChromeLaunchDiagnostics {
|
|
|
152
153
|
profile: string
|
|
153
154
|
temporaryProfile: boolean
|
|
154
155
|
elapsedMs: number
|
|
156
|
+
phase?: ChromeStartupPhase
|
|
157
|
+
phaseStartedMs?: Partial<Record<ChromeStartupPhase, number>>
|
|
155
158
|
exitCodeBeforeCleanup: number | null
|
|
156
159
|
signalCodeBeforeCleanup: string | number | null
|
|
157
160
|
exitCode: number | null
|
|
@@ -210,6 +213,7 @@ export declare interface PageAuditReport {
|
|
|
210
213
|
declare type Listener = (params: any) => void;
|
|
211
214
|
/** Answers a paused request with `cdp.send('Fetch.continueRequest' | 'Fetch.fulfillRequest' | ...)`. */
|
|
212
215
|
export type FetchHandler = (request: PausedRequest, cdp: Cdp) => void | Promise<void>;
|
|
216
|
+
export type ChromeStartupPhase = 'process-acquire' | 'process-start' | 'devtools-port' | 'browser-connect' | 'context-create' | 'target-create' | 'target-discovery' | 'page-connect' | 'page-prepare';
|
|
213
217
|
/** What happened during a visit, in order, for `splitPageLoads`. */
|
|
214
218
|
export type PageAuditEvent = | { type: 'request', request: string }
|
|
215
219
|
/** `sameDocument`: a history API or fragment navigation (`Page.navigatedWithinDocument`), not a new document. */
|
package/dist/browser.js
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
// @bun
|
|
2
|
-
import{closeSync as
|
|
3
|
-
Chrome startup: ${JSON.stringify(e)}`,{cause:t});this.diagnostics=e;this.name="ChromeLaunchError"}}async function
|
|
2
|
+
import{closeSync as oe,existsSync as E,mkdirSync as ie,mkdtempSync as J,openSync as ae,readSync as ce,renameSync as le,rmSync as R}from"fs";import{tmpdir as z}from"os";import{join as v}from"path";import P from"process";async function Y(t,e=12000,r={}){let n=Date.now(),s=await t();while(!s&&Date.now()-n<e)await Bun.sleep(r.intervalMs??100),s=await t();if(!s)throw Error(`Timed out after ${e}ms${r.label?` waiting for ${r.label}`:""}`);return s}var ue=new Set(["Fetch.continueRequest","Fetch.fulfillRequest","Fetch.failRequest","Fetch.continueResponse"]);function de(t,e){let r="";for(let n=0;n<t.length;n++){let s=t[n];if(s==="\\"&&n+1<t.length)r+=U(t[++n]);else if(s==="*")r+="[\\s\\S]*";else if(s==="?")r+="[\\s\\S]";else r+=U(s)}return new RegExp(`^${r}$`).test(e)}function U(t){return t.replace(/[.*+?^${}()|[\]\\/]/g,"\\$&")}function H(t,e){let r=e.responseStatusCode!=null||e.responseErrorReason!=null?"Response":"Request";if((t.requestStage??"Request")!==r)return!1;if(t.resourceType&&t.resourceType!==e.resourceType)return!1;return de(t.urlPattern??"*",e.request?.url??"")}class Q{socket;id=0;pending=new Map;listeners=new Map;commandTimeoutMs;interceptors=[];ownFetch=null;answered=new Map;frameLoaders=new Map;requestLoaders=new Map;errors=[];inFlight=new Map;closed=!1;constructor(t,e={}){this.socket=t;this.commandTimeoutMs=e.commandTimeoutMs??30000,t.addEventListener("close",()=>this.markClosed()),t.addEventListener("message",(r)=>this.receive(String(r.data)))}markClosed(){this.closed=!0,this.frameLoaders.clear(),this.requestLoaders.clear();for(let[t,e]of this.pending)clearTimeout(e.timer),e.reject(Error("Chrome closed the connection")),this.pending.delete(t)}receive(t){let e;try{e=JSON.parse(t)}catch{return}if(e.id){let r=this.pending.get(e.id);if(!r)return;if(this.pending.delete(e.id),clearTimeout(r.timer),e.error)r.reject(Error(e.error.message));else r.resolve(e.result);return}if(this.track(e.method,e.params??{}),e.method==="Fetch.requestPaused"&&!this.routePaused(e.params??{}))return;this.dispatch(e.method,e.params??{})}dispatch(t,e){for(let r of[...this.listeners.get(t)??[]])try{r(e)}catch(n){this.errors.push(`Listener for ${t} threw: ${n?.message??String(n)}`)}}routePaused(t){this.remember(t.requestId,!1);let e=this.interceptors.filter((s)=>s.patterns.some((o)=>H(o,t)));for(let s of e)try{let o=s.handler(t,this);if(o&&typeof o.catch==="function")o.catch((a)=>this.errors.push(`Fetch handler threw: ${a?.message??String(a)}`))}catch(o){this.errors.push(`Fetch handler threw: ${o?.message??String(o)}`)}let r=(this.listeners.get("Fetch.requestPaused")?.size??0)>0,n=this.ownFetch?this.ownFetch.patterns.some((s)=>H(s,t)):!1;if(!e.length&&!n&&!r)this.send("Fetch.continueRequest",{requestId:t.requestId}).catch(()=>{});return r&&(n||!e.length)}remember(t,e){if(this.answered.delete(t),this.answered.set(t,e),this.answered.size>2000){for(let[r]of this.answered)if(this.answered.delete(r),this.answered.size<=1000)break}}async applyFetch(){let t=[...this.interceptors.flatMap((e)=>e.patterns),...this.ownFetch?.patterns??[]];if(!t.length)return await this.command("Fetch.disable");return await this.command("Fetch.enable",{...this.ownFetch?.params,patterns:t})}async intercept(t,e){if(!t.length)throw TypeError("intercept needs at least one pattern");let r={patterns:t.map((s)=>({...s})),handler:e};this.interceptors.push(r);try{await this.applyFetch()}catch(s){throw this.interceptors=this.interceptors.filter((o)=>o!==r),s}let n=!1;return async()=>{if(n)return;if(n=!0,this.interceptors=this.interceptors.filter((s)=>s!==r),!this.closed)await this.applyFetch()}}finishRequest(t){this.inFlight.delete(t),this.requestLoaders.delete(t)}retireFrameRequests(t,e){for(let[r,n]of this.requestLoaders)if(n.frameId===t&&(e===void 0||n.loaderId===e))this.finishRequest(r)}track(t,e){if(t==="Network.requestWillBeSent"){let{requestId:r,frameId:n,loaderId:s}=e;if(this.requestLoaders.delete(r),n&&s)this.requestLoaders.set(r,{frameId:n,loaderId:s});this.inFlight.set(e.requestId,`${e.request?.method} ${e.request?.url}`)}else if(t==="Network.loadingFinished"||t==="Network.loadingFailed")this.finishRequest(e.requestId);else if(t==="Network.responseReceived"&&e.response?.mimeType==="text/event-stream")this.finishRequest(e.requestId);else if(t==="Page.frameNavigated"&&e.frame?.id&&e.frame?.loaderId){let{id:r,loaderId:n}=e.frame,s=this.frameLoaders.get(r);if(s&&s!==n)this.retireFrameRequests(r,s);this.frameLoaders.set(r,n)}else if(t==="Page.frameDetached"&&e.reason==="remove")this.frameLoaders.delete(e.frameId),this.retireFrameRequests(e.frameId);if(t==="Runtime.exceptionThrown")this.errors.push(e.exceptionDetails?.exception?.description||e.exceptionDetails?.text||"Runtime exception");else if(t==="Runtime.consoleAPICalled"&&e.type==="error")this.errors.push((e.args||[]).map((r)=>r.value??r.description??"").join(" "));else if(t==="Log.entryAdded"&&e.entry?.level==="error"&&!String(e.entry.text).includes("favicon"))this.errors.push(e.entry.text);else if(t==="Network.loadingFailed"&&!e.canceled)this.errors.push(`Network: ${e.errorText||"request failed"}`)}on(t,e){let r=this.listeners.get(t);if(!r)this.listeners.set(t,r=new Set);return r.add(e),()=>this.off(t,e)}off(t,e){this.listeners.get(t)?.delete(e)}once(t,e=()=>!0,r=this.commandTimeoutMs){return new Promise((n,s)=>{if(this.closed)return s(Error("Chrome closed the connection"));let o=setTimeout(()=>{i(),clearInterval(a),s(Error(`Timed out after ${r}ms waiting for ${t}`))},r),a=setInterval(()=>{if(!this.closed)return;clearTimeout(o),clearInterval(a),i(),s(Error("Chrome closed the connection"))},100),i=this.on(t,(c)=>{if(!e(c))return;clearTimeout(o),clearInterval(a),i(),n(c)})})}send(t,e={}){if(t==="Fetch.enable"){let{patterns:r,...n}=e;return this.ownFetch={patterns:r?.length?r.map((s)=>({...s})):[{urlPattern:"*"}],params:n},this.closed?this.command(t,e):this.applyFetch()}if(t==="Fetch.disable")return this.ownFetch=null,this.closed?this.command(t,e):this.applyFetch();if(ue.has(t)&&typeof e.requestId==="string"){if(this.answered.get(e.requestId)===!0)return Promise.resolve({});if(this.answered.has(e.requestId))this.remember(e.requestId,!0)}return this.command(t,e)}command(t,e={}){let r=++this.id;return new Promise((n,s)=>{if(this.closed)return s(Error("Chrome closed the connection"));let o=setTimeout(()=>{this.pending.delete(r),s(Error(`Chrome command timed out: ${t}`))},this.commandTimeoutMs);this.pending.set(r,{resolve:n,reject:s,timer:o}),this.socket.send(JSON.stringify({id:r,method:t,params:e}))})}async evaluate(t){let e=await this.send("Runtime.evaluate",{expression:t,awaitPromise:!0,returnByValue:!0});if(e.exceptionDetails)throw Error(e.exceptionDetails.exception?.description||e.exceptionDetails.text);return e.result?.value}disconnect(){this.markClosed();try{this.socket.close()}catch{}}}async function B(t,e={}){let r=new WebSocket(t);return await new Promise((n,s)=>{let o=(u)=>{if(clearTimeout(c),r.removeEventListener("open",a),r.removeEventListener("error",i),r.removeEventListener("close",i),u){try{r.close()}catch{}s(u)}else n()},a=()=>o(),i=()=>o(Error(`Could not connect to Chrome at ${t}`)),c=setTimeout(()=>o(Error(`Timed out connecting to Chrome at ${t}`)),e.connectTimeoutMs??30000);r.addEventListener("open",a,{once:!0}),r.addEventListener("error",i,{once:!0}),r.addEventListener("close",i,{once:!0})}),new Q(r,e)}var X=["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome","/Applications/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing","/Applications/Chromium.app/Contents/MacOS/Chromium","/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary"],he=["google-chrome","google-chrome-stable","chromium","chromium-browser","chrome"],Z=["KSProductID","KSUpdateURL","KSChannelID","KSVersion"],j="dev.stacks.testing.chrome";function pe(){if(P.env.CHROME_PATH)return P.env.CHROME_PATH;if(P.platform==="darwin"){let t=X.find((e)=>E(e));if(t)return t}for(let t of he){let e=Bun.which(t);if(e)return e}return null}function ee(t){let e=/^(.*?\.app)\/Contents\/MacOS\/[^/]+$/.exec(t);return e?e[1]:null}function x(t,e){let r=Bun.spawnSync(["/usr/libexec/PlistBuddy","-c",e,t],{stdout:"pipe",stderr:"pipe"});return{ok:r.exitCode===0,out:r.stdout.toString().trim()}}function fe(t){let e=ee(t);if(!e||P.platform!=="darwin")return!1;let r=v(e,"Contents/Info.plist");return E(r)&&Z.some((n)=>x(r,`Print :${n}`).ok)}function me(t={}){if(P.platform!=="darwin")throw Error("prepareMacChrome is for macOS; elsewhere launch Chrome as installed");let e=t.source??X[0],r=ee(e);if(!r||!E(r))throw Error(`No Chrome app bundle at ${e}`);let n=v(r,"Contents/Info.plist"),s=x(n,"Print :CFBundleShortVersionString").out||"unknown",o=x(n,"Print :CFBundleExecutable").out||"Google Chrome",a=t.directory??v(z(),`stacks-chrome-${s.replace(/[^\w.-]/g,"_")}`),i=v(a,"Chrome.app"),c=v(i,"Contents/MacOS",o),u=v(i,"Contents/Info.plist");if(E(c)&&x(u,"Print :CFBundleIdentifier").out===j&&x(u,"Print :CFBundleShortVersionString").out===s)return{executable:c,app:i,reused:!0};ie(a,{recursive:!0});let f=J(v(a,"staging-")),g=v(f,"Chrome.app"),w=(d,b)=>{let h=Bun.spawnSync(d,{stdout:"pipe",stderr:"pipe"});if(h.exitCode!==0)throw Error(`${b} failed: ${h.stderr.toString().trim()}`)};try{w(["/bin/cp","-cR",r,g],"Cloning Chrome");let d=v(g,"Contents/Info.plist");for(let b of Z)x(d,`Delete :${b}`);w(["/usr/libexec/PlistBuddy","-c",`Set :CFBundleIdentifier ${j}`,d],"Renaming the Chrome bundle"),w(["codesign","--force","--deep","--sign","-",g],"Re-signing Chrome"),R(i,{recursive:!0,force:!0}),le(g,i)}finally{R(f,{recursive:!0,force:!0})}return{executable:c,app:i,reused:!1}}function C(t,e){t.phase=e,t.phaseStartedMs[e]=Date.now()-t.started}class _ extends Error{diagnostics;constructor(t,e){super(`${t instanceof Error?t.message:String(t)}
|
|
3
|
+
Chrome startup: ${JSON.stringify(e)}`,{cause:t});this.diagnostics=e;this.name="ChromeLaunchError"}}async function L(t,e){let r;try{return await Promise.race([t.then(()=>!0),new Promise((n)=>{r=setTimeout(()=>n(!1),e)})])}finally{clearTimeout(r)}}function O(t){let e;try{e=ae(t,"r");let r=Buffer.alloc(1024);return r.subarray(0,ce(e,r,0,r.length,0)).toString("utf8")}catch{return null}finally{if(e!==void 0)try{oe(e)}catch{}}}var ge=["*/_stx/hmr*"];async function we(t,e=ge){if(!e.length)return async()=>{};return await t.intercept(e.map((r)=>({urlPattern:r})),(r,n)=>{n.send("Fetch.fulfillRequest",{requestId:r.requestId,responseCode:200,responseHeaders:[{name:"Content-Type",value:"text/event-stream"}],body:Buffer.from(`retry: 86400000
|
|
4
4
|
|
|
5
|
-
`).toString("base64")}).catch(()=>{})})}function
|
|
6
|
-
[stderr read failed: ${String(
|
|
7
|
-
`)),
|
|
8
|
-
`),
|
|
5
|
+
`).toString("base64")}).catch(()=>{})})}function be(t){let e=t.chromePath??P.env.CHROME_PATH;if(e)return e;let r=pe();if(!r)throw Error("No Chrome found: install Google Chrome or Chromium, or set CHROME_PATH");if((t.stableMacChrome??!0)&&P.platform==="darwin"&&fe(r))return me({source:r}).executable;return r}async function te(t,e,r,n,s){if(C(s,"process-start"),!E(e))throw Error(`Chrome was not found at ${e}`);let o=t.profile||J(v(z(),"stacks-browser-"));R(v(o,"DevToolsActivePort"),{force:!0});let a=v(o,"DevToolsActivePort"),i=(()=>{try{return Bun.spawn([e,...t.headless===!1?[]:["--headless=new"],"--remote-debugging-port=0",`--user-data-dir=${o}`,"--no-first-run","--no-default-browser-check","--disable-background-networking","--disable-component-update","--disable-extensions","--hide-scrollbars","--use-mock-keychain",...t.args??[],"about:blank"],{stdin:"ignore",stdout:"ignore",stderr:"pipe"})}catch(l){let p=null;try{if(!t.profile)R(o,{recursive:!0,force:!0})}catch(m){p=String(m)}throw new _(l,{pid:null,chromePath:e,profile:o,temporaryProfile:!t.profile,elapsedMs:Date.now()-r,phase:s.phase,phaseStartedMs:{...s.phaseStartedMs},exitCodeBeforeCleanup:null,signalCodeBeforeCleanup:null,exitCode:null,signalCode:null,portFileExisted:!1,portFileContents:null,stderrTail:"",stderrTruncated:!1,cleanupError:p})}})(),c="",u=!1,f,g=Promise.resolve(),w,d=()=>w??=(async()=>{let l=!1,p=[];try{if(i.exitCode===null&&i.signalCode===null)try{i.kill("SIGTERM")}catch{}if(!await L(i.exited,2000)){try{i.kill("SIGKILL")}catch{}if(!await L(i.exited,2000))throw Error(`Chrome process ${i.pid} did not exit after SIGKILL`)}l=!0}catch(m){p.push(String(m)),l=i.exitCode!==null||i.signalCode!==null}finally{try{if(!await L(g,100)&&f){if(!await L(f.cancel(),100))throw Error("Chrome stderr cancellation did not finish")}if(!await L(g,100))throw Error("Chrome stderr reader did not finish")}catch(m){p.push(String(m))}finally{if(l&&!t.profile)try{R(o,{recursive:!0,force:!0})}catch(m){p.push(String(m))}}}if(p.length)throw Error(`Chrome cleanup failed: ${p.join("; ")}`)})(),b=()=>i.exitCode!==null||i.signalCode!==null,h=()=>{let l=n-(Date.now()-r);if(l<=0)throw Error(`Timed out after ${n}ms starting Chrome`);if(b())throw Error("Chrome exited during startup");return l},S=async(l,p,m=s)=>{let T=Date.now()-m.started,q=m.phase,A={...m.phaseStartedMs},{exitCode:F,signalCode:I}=i,ne=E(a),se=O(a),N=null;if(p)try{await d()}catch(k){N=k instanceof Error?k.message:String(k)}return new _(l,{pid:i.pid,chromePath:e,profile:o,temporaryProfile:!t.profile,elapsedMs:T,phase:q,phaseStartedMs:A,exitCodeBeforeCleanup:F,signalCodeBeforeCleanup:I,exitCode:i.exitCode,signalCode:i.signalCode,portFileExisted:ne,portFileContents:se,stderrTail:c,stderrTruncated:u,cleanupError:N})};try{f=i.stderr.getReader();let l=f;g=(async()=>{let q=new TextDecoder;for(;;){let{value:A,done:F}=await l.read(),I=q.decode(A,{stream:!F});if(u||=c.length+I.length>16384,c=(c+I).slice(-16384),F)return}})().catch((q)=>{c=`${c}
|
|
6
|
+
[stderr read failed: ${String(q)}]`.slice(-16384)}),C(s,"devtools-port"),await Y(()=>(h(),O(a)?.includes(`
|
|
7
|
+
`)),h(),{label:"Chrome to start"});let[p,m=""]=(O(a)??"").split(`
|
|
8
|
+
`),T=Number(p);if(!Number.isInteger(T)||T<1||T>65535)throw Error("Chrome wrote an invalid DevToolsActivePort");return{pid:i.pid,chromePath:e,profile:o,port:T,browserPath:m.trim(),remaining:h,close:d,failure:S,exited:b}}catch(l){throw await S(l,!0)}}async function D(t,e,r){let n;try{return await Promise.race([t,new Promise((s,o)=>{n=setTimeout(()=>o(Error(`Timed out after ${e}ms ${r}`)),e)})])}finally{clearTimeout(n)}}async function re(t,e){if(await Promise.all([t.send("Page.enable"),t.send("Runtime.enable"),t.send("Network.enable"),t.send("Log.enable"),...e.viewport===!1?[]:[t.send("Emulation.setDeviceMetricsOverride",{deviceScaleFactor:1,mobile:!1,width:1440,height:1000,...e.viewport})]]),e.userAgent!==!1){let r=typeof e.userAgent==="string"?e.userAgent:String((await t.send("Browser.getVersion")).userAgent||"").replace("HeadlessChrome","Chrome");if(r)await t.send("Network.setUserAgentOverride",{userAgent:r})}if(e.quietLiveReload!==!1)await we(t,e.quietLiveReload);if(e.acceptDialogs!==!1)t.on("Page.javascriptDialogOpening",(r)=>{t.errors.push(`Dialog (${r.type}) on ${r.url}: ${r.message||"(no message)"}`),t.send("Page.handleJavaScriptDialog",{accept:!0}).catch(()=>{})})}var ve=1500,y=new Map,M=new Map,G=!1;function ye(){if(G)return;G=!0,P.once("exit",()=>{for(let[t,e]of M){try{P.kill(t,"SIGKILL")}catch{}try{if(e)R(e,{recursive:!0,force:!0})}catch{}}})}async function Ae(){let t=[...y.values()];y.clear(),await Promise.allSettled(t.map(async(e)=>{let r=await e;if(clearTimeout(r.linger),r.browser.disconnect(),await r.chrome.close(),r.chrome.pid!==null)M.delete(r.chrome.pid)}))}async function Ce(t,e,r,n,s,o){let a=y.get(t);if(a){let c=s-(Date.now()-n);if(c<=0)throw Error(`Timed out after ${s}ms starting Chrome`);let u=await D(a.catch(()=>null),c,"waiting for shared Chrome");if(u&&!u.browser.closed&&!u.chrome.exited())return clearTimeout(u.linger),u.sessions++,u;if(y.get(t)===a)y.delete(t)}let i=(async()=>{let c=await te(e,r,n,s,o);if(c.pid!==null)M.set(c.pid,c.profile);try{if(!c.browserPath.startsWith("/devtools/browser/"))throw Error("Chrome wrote no browser endpoint in DevToolsActivePort");C(o,"browser-connect");let u=await B(`ws://127.0.0.1:${c.port}${c.browserPath}`,{...e,connectTimeoutMs:Math.min(e.connectTimeoutMs??30000,c.remaining())});return{chrome:c,browser:u,sessions:0}}catch(u){if(c.pid!==null)M.delete(c.pid);throw await c.failure(u,!0)}})();y.set(t,i),ye();try{let c=await i;return c.sessions++,c}catch(c){if(y.get(t)===i)y.delete(t);throw c}}function W(t,e,r=!1){if(e.sessions=Math.max(0,e.sessions-1),e.sessions>0)return Promise.resolve();let n=async()=>{if(e.sessions>0)return;let s=y.get(t);if(s&&await s.catch(()=>null)===e)y.delete(t);if(e.browser.disconnect(),await e.chrome.close(),e.chrome.pid!==null)M.delete(e.chrome.pid)};if(r)return n();return clearTimeout(e.linger),e.linger=setTimeout(()=>{n().catch(()=>{})},ve),Promise.resolve()}async function Pe(t,e,r,n,s){let o=JSON.stringify([e,t.headless!==!1,t.args??[]]),a=await Ce(o,t,e,r,n,s),i=()=>{let g=n-(Date.now()-r);if(g<=0)throw Error(`Timed out after ${n}ms starting Chrome`);return g},c,u,f=async()=>{if(c&&!a.browser.closed)await a.browser.send("Target.disposeBrowserContext",{browserContextId:c}).catch(()=>{})};try{C(s,"context-create"),c=(await D(a.browser.send("Target.createBrowserContext",{disposeOnDetach:!1}),i(),"creating a browser context")).browserContextId,C(s,"target-create");let{targetId:g}=await D(a.browser.send("Target.createTarget",{url:"about:blank",browserContextId:c}),i(),"opening a page"),w=`ws://127.0.0.1:${a.chrome.port}/devtools/page/${g}`;C(s,"page-connect");let d=u=await B(w,{...t,connectTimeoutMs:Math.min(t.connectTimeoutMs??30000,i())});C(s,"page-prepare"),await D(re(d,t),i(),"preparing the page"),i();let b;return{cdp:d,close:()=>b??=(async()=>{d.disconnect(),await f(),await W(o,a)})(),target:w,port:a.chrome.port,chromePath:e}}catch(g){u?.disconnect(),await f();let w=a.sessions<=1,d=await a.chrome.failure(g,!1,s);throw await W(o,a,w).catch((b)=>{d.diagnostics.cleanupError=b instanceof Error?b.message:String(b)}),d}}async function Se(t,e,r,n,s){let o=await te(t,e,r,n,s),a,i,c=()=>i??=(async()=>{a?.disconnect(),await o.close()})(),u=setTimeout(()=>a?.disconnect(),Math.max(1,n-(Date.now()-r)));try{let f=o.port;C(s,"target-discovery");let g=await Y(async()=>{let d=await fetch(`http://127.0.0.1:${f}/json/list`,{signal:AbortSignal.timeout(Math.min(1000,o.remaining()))}).then((b)=>b.json()).catch(()=>[]);return Array.isArray(d)&&d.length?d:null},Math.min(12000,o.remaining()),{label:"a page target"}),w=g.find((d)=>d.type==="page"&&d.url==="about:blank")||g.find((d)=>d.type==="page");if(!w)throw Error("Chrome did not expose a page target");return C(s,"page-connect"),a=await B(w.webSocketDebuggerUrl,{...t,connectTimeoutMs:Math.min(t.connectTimeoutMs??30000,o.remaining())}),o.remaining(),C(s,"page-prepare"),await re(a,t),o.remaining(),clearTimeout(u),{cdp:a,close:c,target:w.webSocketDebuggerUrl,port:f,chromePath:e}}catch(f){throw clearTimeout(u),a?.disconnect(),await o.failure(f,!0)}}async function Te(t={}){let e=t.startTimeoutMs??30000;if(!Number.isFinite(e)||e<=0)throw RangeError("startTimeoutMs must be positive and finite");let r=be(t),n=Date.now(),s={started:n,phase:"process-acquire",phaseStartedMs:{"process-acquire":0}};return!t.profile&&t.shared!==!1&&P.env.STACKS_BROWSER_SHARED!=="0"?await Pe(t,r,n,e,s):await Se(t,r,n,e,s)}async function xe(t,e={}){let r=e.quietMs??1000,n=e.timeoutMs??15000,s=Date.now(),o=0;while(Date.now()-s<n){if(t.closed)throw Error("Chrome closed the connection");if(t.inFlight.size>0||await t.evaluate("document.readyState !== 'complete'").catch(()=>!0))o=0;else if(!o)o=Date.now();else if(Date.now()-o>=r)return!0;await Bun.sleep(100)}return!1}async function Re(t,e,r={}){let n=await t.send("Page.navigate",{url:e});if(n?.errorText)throw Error(`Could not open ${e}: ${n.errorText}`);return await xe(t,r)}var Ee=(t)=>t.pathname.startsWith("/api/")&&!t.pathname.endsWith("/events");function qe(t){let e={};for(let r of t)e[r]=(e[r]||0)+1;return Object.fromEntries(Object.entries(e).filter(([,r])=>r>1))}function V(t){try{let e=new URL(t);return`${e.origin}${e.pathname}`}catch{return t.replace(/[?#].*$/,"")}}function $e(t,e,r="navigation"){let n=[{url:t,apiRequests:[]}],s=!1;for(let o of e){let a=n.at(-1);if(o.type==="request"){a.apiRequests.push(o.request);continue}let i=r==="navigation"&&s&&(o.sameDocument?V(o.url)!==V(a.url):!0);if(s=!0,i)n.push({url:o.url,apiRequests:[]});else a.url=o.url}return n.map((o)=>({...o,duplicates:qe(o.apiRequests)}))}function Le(t){let e={};for(let r of t)for(let[n,s]of Object.entries(r.duplicates))e[n]=Math.max(e[n]??0,s);return e}async function ke(t,e={}){let r=Date.now(),n=new URL(t).origin,s=e.isApiRequest??Ee,o=[],a=[],i=[],c=null,u=e.cdp,f=[],g=u?.errors.length??0,w,d=t,b=async(h,S=[])=>{let l=$e(t,a,e.pageLoads),p=d;if(u&&!u.closed){let m=await u.evaluate("location.href").catch(()=>null);if(m&&m!=="about:blank"&&!m.startsWith("chrome-error:"))p=m}return{url:t,finalUrl:p,apiRequests:o,duplicates:Le(l),loads:l,failed:i,errors:[...u?.errors.slice(g)??[],...S],settled:h,durationMs:Date.now()-r}};try{if(!u)c=await Te(e.launch),u=c.cdp;let h=u;if(f.push(h.on("Network.requestWillBeSent",(l)=>{let p=new URL(l.request.url);if(p.origin===n&&s(p,l.request.method)){let m=`${l.request.method} ${p.pathname}${p.search}`;o.push(m),a.push({type:"request",request:m})}})),f.push(h.on("Network.responseReceived",(l)=>{let p=new URL(l.response.url);if(p.origin===n&&l.response.status>=400)i.push(`${l.response.status} ${p.pathname}`)})),f.push(h.on("Page.frameNavigated",(l)=>{if(l.frame?.parentId)return;w=l.frame?.id??w,d=l.frame?.unreachableUrl||`${l.frame?.url??d}${l.frame?.urlFragment??""}`,a.push({type:"navigated",url:d,sameDocument:!1})})),f.push(h.on("Page.navigatedWithinDocument",(l)=>{if(w&&l.frameId!==w)return;d=l.url,a.push({type:"navigated",url:l.url,sameDocument:!0})})),await h.send("Page.enable"),w=(await h.send("Page.getFrameTree").catch(()=>null))?.frameTree?.frame?.id,e.viewport)await h.send("Emulation.setDeviceMetricsOverride",{deviceScaleFactor:1,mobile:!1,...e.viewport});await e.beforeNavigate?.(h);let S=await Re(h,t,e);return await b(S)}catch(h){return await b(!1,[`audit: ${h?.message??String(h)}`])}finally{for(let h of f)h();await c?.close().catch(()=>{})}}function K(t){try{let e=new URL(t);return`${e.pathname}${e.search}`}catch{return t}}function Oe(t){let e=K(t.url),r=t.finalUrl?K(t.finalUrl):e,n=Object.entries(t.duplicates).map(([s,o])=>`${o}x ${s}`);return`${e}${r!==e?` -> ${r}`:""}: ${t.apiRequests.length} api${n.length?` | dup ${n.join(", ")}`:""}${t.failed.length?` | failed ${t.failed.join(", ")}`:""}${t.errors.length?` | errors ${t.errors.slice(0,3).join(" ; ")}`:""}${t.settled?"":" | never settled"}`}function _e(t){return t.settled&&!Object.keys(t.duplicates).length&&!t.failed.length&&!t.errors.length}export{Q as Cdp,_ as ChromeLaunchError,ge as LIVE_RELOAD_PATTERNS,ve as SHARED_CHROME_LINGER_MS,ke as auditPage,fe as chromeHasUpdater,Ae as closeSharedBrowsers,B as connect,qe as duplicateRequests,pe as findChrome,Oe as formatPageAudit,Te as launch,Le as loadDuplicates,de as matchesUrlPattern,Re as navigate,_e as pageAuditClean,H as pausedRequestMatches,me as prepareMacChrome,we as quietLiveReload,xe as settle,$e as splitPageLoads,Y as waitFor};
|
package/package.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"name": "@stacksjs/testing",
|
|
3
3
|
"type": "module",
|
|
4
4
|
"sideEffects": false,
|
|
5
|
-
"version": "0.75.
|
|
5
|
+
"version": "0.75.308",
|
|
6
6
|
"description": "The Stacks way of testing.",
|
|
7
7
|
"author": "Chris Breuer",
|
|
8
8
|
"contributors": [
|
|
@@ -79,16 +79,16 @@
|
|
|
79
79
|
"prepublishOnly": "bun run build"
|
|
80
80
|
},
|
|
81
81
|
"dependencies": {
|
|
82
|
-
"@stacksjs/auth": "0.75.
|
|
83
|
-
"@stacksjs/cache": "0.75.
|
|
84
|
-
"@stacksjs/config": "0.75.
|
|
85
|
-
"@stacksjs/database": "0.75.
|
|
86
|
-
"@stacksjs/email": "0.75.
|
|
87
|
-
"@stacksjs/events": "0.75.
|
|
88
|
-
"@stacksjs/path": "0.75.
|
|
89
|
-
"@stacksjs/router": "0.75.
|
|
90
|
-
"@stacksjs/storage": "0.75.
|
|
91
|
-
"@stacksjs/strings": "0.75.
|
|
82
|
+
"@stacksjs/auth": "0.75.308",
|
|
83
|
+
"@stacksjs/cache": "0.75.308",
|
|
84
|
+
"@stacksjs/config": "0.75.308",
|
|
85
|
+
"@stacksjs/database": "0.75.308",
|
|
86
|
+
"@stacksjs/email": "0.75.308",
|
|
87
|
+
"@stacksjs/events": "0.75.308",
|
|
88
|
+
"@stacksjs/path": "0.75.308",
|
|
89
|
+
"@stacksjs/router": "0.75.308",
|
|
90
|
+
"@stacksjs/storage": "0.75.308",
|
|
91
|
+
"@stacksjs/strings": "0.75.308",
|
|
92
92
|
"@stacksjs/ts-cloud": "^0.16.69",
|
|
93
93
|
"very-happy-dom": "^0.3.5"
|
|
94
94
|
},
|