Application
Navigate and inspect your app from a test. Tests have their own context and read the app DOM directly. Fresh documents don’t reset browser storage or backend data.
Properties
Section titled “Properties”| Property | Modifier | Type | Description |
|---|---|---|---|
document |
readonly |
Document |
Read the current app document after navigation is ready. Resolve elements again after navigation. |
native |
readonly |
NativeBrowser |
Use managed browser features such as native input and permissions. Required operations fail when unsupported. |
window |
readonly |
Window & typeof globalThis |
Read the current app window. Browser APIs are available directly; use Interactor assertions for changing state. |
Methods
Section titled “Methods”fixture()
Section titled “fixture()”fixture<
T=unknown>(name:string,input?:unknown):Promise<T>
Call a named fixture in this worker’s actual app process. Dyno supplies the execution capability, bounded JSON, cancellation, and a named timing step. Configure the optional fixture controller through beforeExecution. Omitted input is null. Calls never retry or follow redirects; abort cannot undo a committed write. Await every call before finishing the test or hook.
Type Parameters
Section titled “Type Parameters”| Type Parameter | Default type |
|---|---|
T |
unknown |
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
name |
string |
input? |
unknown |
Returns
Section titled “Returns”Promise<T>
goto()
Section titled “goto()”goto(
path:string):Promise<void>
Navigate to a same-origin app path and wait for its document bridge. Then use Interactor to wait for the UI you care about.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
path |
string |
Returns
Section titled “Returns”Promise<void>
pause()
Section titled “pause()”pause(
message?:string):Promise<void>
Open the reporter and suspend the execution deadline until Continue. Requires --ui or --manual. App timers and network work keep running; cleanup cannot pause.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
message? |
string |
Returns
Section titled “Returns”Promise<void>
request()
Section titled “request()”request(
path:string,options?:RequestInit):Promise<Response>
Fetch options pass through, including credentials: 'omit' for API setup that should not change the browser session. Same-origin cookies are included by default. Dyno owns the cancellation signal.
Fetch a same-origin URL using the browser session and test cancellation signal. Returns a standard Response. Use this for your app’s test-only fixture endpoints; keep database factories in your project.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
path |
string |
options? |
RequestInit |
Returns
Section titled “Returns”Promise<Response>
screenshot()
Section titled “screenshot()”screenshot(
name:string,options?:ScreenshotOptions):Promise<Screenshot>
Save an exact PNG of the app, excluding the reporter. Full-page and element captures are supported. Required capture fails when unavailable; explicitly optional capture can skip.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
name |
string |
options? |
ScreenshotOptions |
Returns
Section titled “Returns”Promise<Screenshot>
setViewport()
Section titled “setViewport()”Resize the actual managed viewport and wait for layout. Each dimension must be 1–16384 CSS pixels. Manual runs require the requested dimensions to already match.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
viewport |
Viewport |
Returns
Section titled “Returns”Promise<Viewport>