Class Sandbox

constructor

• new Sandbox(client: ModalClient, sandboxId: string): Sandbox
  Internal

  Parameters

  • client: ModalClient
  • sandboxId: string

  Returns Sandbox

ReadonlysandboxId

stderr

• get stderr(): ModalReadStream<string>

  Returns ModalReadStream<string>

  Description

  Sandboxの標準エラー出力ストリーム

stdin

• get stdin(): ModalWriteStream<string>

  Returns ModalWriteStream<string>

  Description

  Sandboxの標準入力ストリーム

stdout

• get stdout(): ModalReadStream<string>

  Returns ModalReadStream<string>

  Description

  Sandboxの標準出力ストリーム

createConnectToken

• createConnectToken(
      params?: SandboxCreateConnectTokenParams,
  ): Promise<SandboxCreateConnectCredentials>

  Create a token for making HTTP connections to the Sandbox.

  Parameters

  • Optionalparams: SandboxCreateConnectTokenParams

  Returns Promise<SandboxCreateConnectCredentials>

detach

• detach(): void

  Returns void

  Description

  Sandboxとの接続を切断しローカルリソースを解放する(Sandbox自体はModal上で継続動作)

exec

• exec(
      command: string[],
      params?: SandboxExecParams & { mode?: "text" },
  ): Promise<ContainerProcess<string>>

  Parameters

  • command: string[]
  • Optionalparams: SandboxExecParams & { mode?: "text" }

  Returns Promise<ContainerProcess<string>>

• exec(
      command: string[],
      params: SandboxExecParams & { mode: "binary" },
  ): Promise<ContainerProcess<Uint8Array<ArrayBufferLike>>>

  Parameters

  • command: string[]
  • params: SandboxExecParams & { mode: "binary" }

  Returns Promise<ContainerProcess<Uint8Array<ArrayBufferLike>>>

getTags

• getTags(): Promise<Record<string, string>>

  Returns Promise<Record<string, string>>

  タグのキーバリューマッピング

  Description

  Sandboxに設定されているタグを取得する

mountImage

• mountImage(path: string, image?: Image): Promise<void>

  Mount an Image at a path in the Sandbox filesystem.

  Parameters

  • path: string

    The path where the directory should be mounted

  • Optionalimage: Image

    Optional Image to mount. If undefined, mounts an empty directory.

  Returns Promise<void>

open

• open(path: string, mode?: SandboxFileMode): Promise<SandboxFile>

  Open a file in the Sandbox filesystem.

  Parameters

  • path: string

    Path to the file to open

  • mode: SandboxFileMode = "r"

    File open mode (r, w, a, r+, w+, a+)

  Returns Promise<SandboxFile>

  Promise that resolves to a SandboxFile

poll

• poll(): Promise<number | null>

  Check if the Sandbox has finished running.

  Returns null if the Sandbox is still running, else returns the exit code.

  Returns Promise<number | null>

setTags

• setTags(tags: Record<string, string>): Promise<void>

  Parameters

  • tags: Record<string, string>

    タグのキーバリューマッピング

  Returns Promise<void>

  Description

  Sandboxにタグ(キーバリューペア)を設定する

snapshotDirectory

• snapshotDirectory(path: string): Promise<Image>

  Snapshots and creates a new Image from a directory in the running sandbox.

  Parameters

  • path: string

    The path of the directory to snapshot

  Returns Promise<Image>

  Promise that resolves to an Image

snapshotFilesystem

• snapshotFilesystem(timeoutMs?: number): Promise<Image>

  Snapshot the filesystem of the Sandbox.

  Returns an Image object which can be used to spawn a new Sandbox with the same filesystem.

  Parameters

  • timeoutMs: number = 55000

    Timeout for the snapshot operation in milliseconds

  Returns Promise<Image>

  Promise that resolves to an Image

terminate

• terminate(): Promise<undefined>

  Returns Promise<undefined>

  wait: trueの場合はexit code

  Description

  Sandboxを終了する

• terminate(params: { wait: true }): Promise<number>

  Parameters

  • params: { wait: true }

    オプションパラメータ(waitでexit codeを返す)

  Returns Promise<number>

  wait: trueの場合はexit code

  Description

  Sandboxを終了する

tunnels

• tunnels(timeoutMs?: number): Promise<Record<number, Tunnel>>

  Parameters

  • timeoutMs: number = 50000

    タイムアウト(ミリ秒)

  Returns Promise<Record<number, Tunnel>>

  コンテナポートをキーとしたTunnelのマッピング

  Description

  SandboxのTunnelメタデータを取得する

  Default

  50000
  Copy

  Throws

  SandboxTimeoutError タイムアウト時

wait

• wait(): Promise<number>

  Returns Promise<number>

  exit code

  Description

  Sandboxの終了を待機してexit codeを返す

waitUntilReady

• waitUntilReady(timeoutMs?: number): Promise<void>

  Parameters

  • timeoutMs: number = 300_000

    最大待機時間(ミリ秒)

  Returns Promise<void>

  Description

  readinessプローブが成功するまでブロック

  Default

  300000
  Copy

StaticfromId

• fromId(sandboxId: string): Promise<Sandbox>

  Parameters

  • sandboxId: string

  Returns Promise<Sandbox>

  Deprecated

  Use client.sandboxes.fromId() instead.

StaticfromName

• fromName(appName: string, name: string, environment?: string): Promise<Sandbox>

  Parameters

  • appName: string
  • name: string
  • Optionalenvironment: string

  Returns Promise<Sandbox>

  Deprecated

  Use client.sandboxes.fromName() instead.

Staticlist

• list(params?: SandboxListParams): AsyncGenerator<Sandbox, void, unknown>

  Parameters

  • params: SandboxListParams = {}

  Returns AsyncGenerator<Sandbox, void, unknown>

  Deprecated

  Use client.sandboxes.list() instead.