Class IDLTest

Base fixture for testing the exposed interface is correct (without actually using WebGPU).

Hierarchy

Fixture
- IDLTest

Accessors

params

get params(): unknown
Returns the (case+subcase) parameters for this test function invocation.

Returns unknown
Inherited from Fixture.params
- Defined in src/common/framework/fixture.ts:90

sharedState

get sharedState(): S
Gets the test fixture's shared state. This object is shared between subcases within the same testcase.

Returns S
Inherited from Fixture.sharedState
- Defined in src/common/framework/fixture.ts:98

Methods

assertMember

assertMember(act, exp, key): void
Asserts that a member of an IDL interface has the expected value.
Parameters
- act: object
- exp: object
- key: string
Returns void
- Defined in src/webgpu/idl/idl_test.ts:22

assertMemberCount

assertMemberCount(act, exp): void
Asserts that an IDL interface has the same number of keys as the

MAINTENANCE_TODO: add a way to check for the types of keys with unknown values, like methods and attributes MAINTENANCE_TODO: handle extensions
Parameters
- act: object
- exp: object
Returns void
- Defined in src/webgpu/idl/idl_test.ts:35

debug

debug(msg): void
Log a debug message.
Parameters
- msg: string
Returns void
Inherited from Fixture.debug
- Defined in src/common/framework/fixture.ts:204

eventualAsyncExpectation

eventualAsyncExpectation<T>(fn): void
Wraps an async function, passing it an Error object recording the original stack trace. The async work will be implicitly waited upon before reporting a test status.
Type Parameters
- T
Parameters
- fn: ((niceStack) => Promise<T>)
  - - (niceStack): Promise<T>
    - Parameters
      niceStack: Error
      Returns Promise<T>
Returns void
Inherited from Fixture.eventualAsyncExpectation
- Defined in src/common/framework/fixture.ts:253

eventualExpectOK

eventualExpectOK(error, __namedParameters?): void
Parameters
- error: Promise<undefined | Error | (undefined | Error)[]>
- __namedParameters: {
  mode?: "fail" | "warn";
  } = {}
  - Optional mode?: "fail" | "warn"
Returns void
Inherited from Fixture.eventualExpectOK
- Defined in src/common/framework/fixture.ts:392

expect

expect(cond, msg?): boolean
Expect that a condition is true.
Parameters
- cond: boolean
- Optional msg: string
Returns boolean
Inherited from Fixture.expect
- Defined in src/common/framework/fixture.ts:350

expectOK

expectOK(error, __namedParameters?): void
If the argument is an Error, fail (or warn). If it's undefined, no-op. If the argument is an array, apply the above behavior on each of elements.
Parameters
- error: undefined | Error | (undefined | Error)[]
- __namedParameters: {
  mode?: "fail" | "warn";
  niceStack?: Error;
  } = {}
  - Optional mode?: "fail" | "warn"
  - Optional niceStack?: Error
Returns void
Inherited from Fixture.expectOK
- Defined in src/common/framework/fixture.ts:364

fail

fail(msg?): void
Log an error and increase the result status to "ExpectFailed".
Parameters
- Optional msg: string
Returns void
Inherited from Fixture.fail
- Defined in src/common/framework/fixture.ts:234

info

info(msg): void
Log an info message. Use sparingly. Use debug() instead if logs are only needed with debug logging enabled.
Parameters
- msg: string
Returns void
Inherited from Fixture.info
- Defined in src/common/framework/fixture.ts:212

init

init(): Promise<void>
Returns Promise<void>
Overrides Fixture.init
- Defined in src/webgpu/idl/idl_test.ts:13

requestDeviceTracked

requestDeviceTracked(adapter, desc?): Promise<GPUDevice>
Call requestDevice() and track the device for cleanup.
Parameters
- adapter: GPUAdapter
- desc: undefined | GPUDeviceDescriptor = undefined
Returns Promise<GPUDevice>
Inherited from Fixture.requestDeviceTracked
- Defined in src/common/framework/fixture.ts:198

shouldReject

shouldReject(expectedName, p, __namedParameters?): void
Expect that the provided promise rejects, with the provided exception name.
Parameters
- expectedName: string
- p: Promise<unknown>
- __namedParameters: ExceptionCheckOptions = {}
Returns void
Inherited from Fixture.shouldReject
- Defined in src/common/framework/fixture.ts:292

shouldResolve

shouldResolve(p, msg?): void
Expect that the provided promise resolves (fulfills).
Parameters
- p: Promise<unknown>
- Optional msg: string
Returns void
Inherited from Fixture.shouldResolve
- Defined in src/common/framework/fixture.ts:275

shouldThrow

shouldThrow(expectedError, fn, __namedParameters?): void
Expect that the provided function throws (if true or string) or not (if false). If a string is provided, expect that the throw exception has that name.

MAINTENANCE_TODO: Change to string | false so the exception name is always checked.
Parameters
- expectedError: string | boolean
- fn: (() => void)
  - - (): void
    - Returns void
- __namedParameters: ExceptionCheckOptions = {}
Returns void
Inherited from Fixture.shouldThrow
- Defined in src/common/framework/fixture.ts:322

skip

skip(msg): never
Throws an exception marking the subcase as skipped.
Parameters
- msg: string
Returns never
Inherited from Fixture.skip
- Defined in src/common/framework/fixture.ts:217

skipIf

skipIf(cond, msg?): void
Throws an exception marking the subcase as skipped if condition is true
Parameters
- cond: boolean
- msg: string | (() => string) = ''
Returns void
Inherited from Fixture.skipIf
- Defined in src/common/framework/fixture.ts:222

trackForCleanup

trackForCleanup<T>(o): T
Tracks an object to be cleaned up after the test finishes.

Usually when creating buffers/textures/query sets, you can use the helpers in GPUTest instead.
Type Parameters
- T extends DestroyableObject | Promise<DestroyableObject>
Parameters
- o: T
Returns T
Inherited from Fixture.trackForCleanup
- Defined in src/common/framework/fixture.ts:158

tryTrackForCleanup

tryTrackForCleanup<T>(o): T
Tracks an object, if it's destroyable, to be cleaned up after the test finishes.
Type Parameters
- T
Parameters
- o: T
Returns T
Inherited from Fixture.tryTrackForCleanup
- Defined in src/common/framework/fixture.ts:183

warn

warn(msg?): void
Log a warning and increase the result status to "Warn".
Parameters
- Optional msg: string
Returns void
Inherited from Fixture.warn
- Defined in src/common/framework/fixture.ts:229

`Static` MakeSharedState

MakeSharedState(recorder, params): SubcaseBatchState
Parameters
- recorder: TestCaseRecorder
- params: TestParams
Returns SubcaseBatchState
Inherited from Fixture.MakeSharedState
- Defined in src/common/framework/fixture.ts:76

Class IDLTest

Hierarchy

Index

Accessors

Methods

Accessors

params

Returns unknown

sharedState

Returns S

Methods

assertMember

Parameters

act: object

exp: object

key: string

Returns void

assertMemberCount

Parameters

act: object

exp: object

Returns void

debug

Parameters

msg: string

Returns void

eventualAsyncExpectation

Type Parameters

T

Parameters

fn: ((niceStack) => Promise<T>)

Parameters

niceStack: Error

Returns Promise<T>

Returns void

eventualExpectOK

Parameters

error: Promise<undefined | Error | (undefined | Error)[]>

__namedParameters: { mode?: "fail" | "warn"; } = {}

Optional mode?: "fail" | "warn"

Returns void

expect

Parameters

cond: boolean

Optional msg: string

Returns boolean

expectOK

Parameters

error: undefined | Error | (undefined | Error)[]

__namedParameters: { mode?: "fail" | "warn"; niceStack?: Error; } = {}

Optional mode?: "fail" | "warn"

Optional niceStack?: Error

Returns void

fail

Parameters

Optional msg: string

Returns void

info

Parameters

msg: string

Returns void

init

Returns Promise<void>

requestDeviceTracked

Parameters

adapter: GPUAdapter

desc: undefined | GPUDeviceDescriptor = undefined

Returns Promise<GPUDevice>

shouldReject

Parameters

expectedName: string

p: Promise<unknown>

__namedParameters: ExceptionCheckOptions = {}

Returns void

shouldResolve

Parameters

p: Promise<unknown>

Optional msg: string

Returns void

shouldThrow

__namedParameters: {
mode?: "fail" | "warn";
} = {}

`Optional` mode?: "fail" | "warn"

`Optional` msg: string

__namedParameters: {
mode?: "fail" | "warn";
niceStack?: Error;
} = {}

`Optional` mode?: "fail" | "warn"

`Optional` niceStack?: Error

`Optional` msg: string

`Optional` msg: string

`Optional` msg: string

`Static` MakeSharedState