DocsReferenceGuidesBlog
Discord logo
Discord
GitHub logo

ShellError

Bun

Symbol

$.ShellError

  • cause?: unknown

    The cause of the error.

  • readonly exitCode: number
  • message: string
  • name: string
  • stack?: string
  • readonly stderr: Buffer
  • readonly stdout: Buffer
  • static prepareStackTrace?: (err: Error, stackTraces: CallSite[]) => any

    Optional override for formatting stack traces

  • static stackTraceLimit: number

    The maximum number of stack frames to capture.

  • Read from stdout as an ArrayBuffer

    @returns

    Stdout as an ArrayBuffer

    const output = await $`echo hello`;
console.log(output.arrayBuffer()); // ArrayBuffer { byteLength: 6 }

  • Read from stdout as a Blob

    @returns

    Stdout as a blob

    const output = await $`echo hello`;
console.log(output.blob()); // Blob { size: 6, type: "" }

  • Read from stdout as an Uint8Array

    @returns

    Stdout as an Uint8Array

    const output = await $`echo hello`;
console.log(output.bytes()); // Uint8Array { byteLength: 6 }
  • json(): any

    Read from stdout as a JSON object

    @returns

    Stdout as a JSON object

    const output = await $`echo '{"hello": 123}'`;
console.log(output.json()); // { hello: 123 }
  • text(encoding?: BufferEncoding): string

    Read from stdout as a string

    @param encoding

    The encoding to use when decoding the output

    @returns

    Stdout as a string with the given encoding

    Read as UTF-8 string

    const output = await $`echo hello`;
console.log(output.text()); // "hello\n"

    Read as base64 string

    const output = await $`echo ${atob("hello")}`;
console.log(output.text("base64")); // "hello\n"
  • static captureStackTrace(targetObject: object, constructorOpt?: Function): void

    Create .stack property on a target object

  • static isError(value: unknown): value is Error

    Check if a value is an instance of Error

    @param value

    The value to check

    @returns

    True if the value is an instance of Error, false otherwise