An Abort instance emits an 'abort' event when aborted.

A native AbortController is encapsulated if the platform supports it, allowing for fetch cancellation.

Hierarchy (view full)

Implements

Constructors

Properties

logPrefix: string = ...

A string prefix for all log statements made by this target.

Accessors

  • get [toStringTag](): string
  • Returns string

  • get aborted(): boolean
  • True if this signal is aborted.

    Returns boolean

  • get nativeSignal(): null | AbortSignal
  • Returns a native signal on supported platforms.

    Returns null | AbortSignal

  • get reason(): null | Error
  • A JavaScript value providing the abort reason, once this signal has aborted.

    Returns null | Error

Methods

  • Sets to the aborted state with the given reason, and emits an 'abort' event. If this signal is already aborted, this will do nothing.

    Parameters

    • reason: Error = ...

    Returns void

  • Dispatches an event.

    Type Parameters

    • K extends "abort"

    Parameters

    • type: K

      The key of the event within EventMap

    • event: AbortEventMap[K]

      If the passed event is read-only, then it may be re-used/cached. Otherwise, it should be a new event object every dispatch. If no target property is set on the event, the target will be set to this host.

    Returns void

  • Returns true if the event host has any listeners for the given type.

    Parameters

    • type: "abort"

    Returns boolean

  • Adds an event handler for the given typed event.

    Type Parameters

    • K extends "abort"

    Parameters

    • type: K

      The key representing the event type to listen for.

    • handler: EventHandler<AbortEventMap[K]>

      A callback to invoke when the event with the given type is dispatched.

    • Optionaloptions: SignalOptions

      Options for changing listening behavior.

    Returns Unsubscribe

    Returns a method, when invoked, removes the handler.

  • Throws this signal's abort reason if the signal has been aborted; otherwise it does nothing.

    Returns void