StartPlaygroundOptions

Index

Properties

• blueprint
• corsProxy
• disableProgressBar
• experimentalBlueprintsV2Runner
• iframe
• mounts
• onBlueprintStepCompleted
• onBlueprintValidated
• onClientConnected
• progressTracker
• remoteUrl
• scope
• shouldInstallWordPress
• sqliteDriverVersion

Properties

optionalblueprint

blueprint?: BlueprintV1

optionalcorsProxy

corsProxy?: string

Proxy URL to use for cross-origin requests.

For example, if corsProxy is set to "https://cors.wordpress.net/proxy.php", then the CORS requests to https://github.com/WordPress/wordpress-playground.git would actually be made to https://cors.wordpress.net/proxy.php?https://github.com/WordPress/wordpress-playground.git.

The Blueprints library will arbitrarily choose which requests to proxy. If you need to proxy every single request, do not use this option. Instead, you should preprocess your Blueprint to replace all cross-origin URLs with the proxy URL.

optionaldisableProgressBar

disableProgressBar?: boolean

optionalexperimentalBlueprintsV2Runner

experimentalBlueprintsV2Runner?: boolean

Prefer experimental Blueprints v2 PHP runner instead of TypeScript steps

iframe

iframe: HTMLIFrameElement

optionalmounts

mounts?: MountDescriptor[]

optionalonBlueprintStepCompleted

onBlueprintStepCompleted?: OnStepCompleted

optionalonBlueprintValidated

onBlueprintValidated?: (blueprint: BlueprintV1Declaration) => void

Type declaration

• • (blueprint: BlueprintV1Declaration): void

  • Parameters

    • blueprint: BlueprintV1Declaration

    Returns void

optionalonClientConnected

onClientConnected?: (playground: PlaygroundClient) => void

Called when the playground client is connected, but before the blueprint steps are run.

@returns

---

Type declaration

• • (playground: PlaygroundClient): void

  • Parameters

    • playground: PlaygroundClient

    Returns void

optionalprogressTracker

progressTracker?: ProgressTracker

remoteUrl

remoteUrl: string

optionalscope

scope?: string

The string prefix used in the site URL served by the currently running remote.html. E.g. for a prefix like /scope:playground/, the scope would be playground. See the @php-wasm/scopes package for more details.

optionalshouldInstallWordPress

shouldInstallWordPress?: boolean

optionalsqliteDriverVersion

sqliteDriverVersion?: string

The version of the SQLite driver to use. Defaults to the latest development version.