@freedomofpress/webcat
    Preparing search index...

    Class WebcatRequestHandler

    Handles web requests and responses for specific FQDNs. Manages the entire lifecycle of a request and aggregates details such as request headers and response headers to make them available in later stages.

    Hierarchy (View Summary)

    Index
    addEventListener: (
        type: string,
        callback: EventListenerOrEventListenerObject | null,
        options?: boolean | AddEventListenerOptions,
    ) => void & (
        type: "beforerequest",
        callback: (event: RequestEvent<BeforeRequestDetails>) => void,
    ) => void & (
        type: "beforeheaders",
        callback: (event: RequestEvent<BeforeHeadersDetails>) => void,
    ) => void & (
        type: "headersreceived",
        callback: (event: RequestEvent<HeadersReceivedDetails>) => void,
    ) => void & (
        type: "erroroccurred",
        callback: (event: RequestEvent<ErrorOccurredDetails>) => void,
    ) => void & (
        type: "completed",
        callback: (event: RequestEvent<CompletedDetails>) => void,
    ) => void & (
        type: "beforeframeload",
        callback: (event: RequestEvent<BeforeRequestDetails>) => void,
    ) => void

    Type Declaration

      • (
            type: string,
            callback: EventListenerOrEventListenerObject | null,
            options?: boolean | AddEventListenerOptions,
        ): void
      • The addEventListener() method of the EventTarget interface sets up a function that will be called whenever the specified event is delivered to the target.

        MDN Reference

        Parameters

        • type: string
        • callback: EventListenerOrEventListenerObject | null
        • Optionaloptions: boolean | AddEventListenerOptions

        Returns void

    • Binds the handler to the given list of FQDNs. When called, the handler starts handling requests for the FQDNs in the list and stops handling requests for any previously bound FQDNs that are not in the new list.

      Parameters

      • fqdns: string[]

        A list of fully-qualified domain names to bind to.

      Returns Promise<void>

    • Binds the handler to <all_urls>. Unlike bind, does not bind content scripts. The bindAll method can be called synchronously before FQDNs are available, but it should be always followed by a call to bind to both restrict the scope of the binding and bind content scripts.

      Returns void

    • The dispatchEvent() method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order. The normal event processing rules (including the capturing and optional bubbling phase) also apply to events dispatched manually with dispatchEvent().

      MDN Reference

      Parameters

      • event: Event

      Returns boolean

    • The removeEventListener() method of the EventTarget interface removes an event listener previously registered with EventTarget.addEventListener() from the target. The event listener to be removed is identified using a combination of the event type, the event listener function itself, and various optional options that may affect the matching process; see Matching event listeners for removal.

      MDN Reference

      Parameters

      • type: string
      • callback: EventListenerOrEventListenerObject | null
      • Optionaloptions: boolean | EventListenerOptions

      Returns void