FetchEvent
This is the event type for fetch
events. It contains information about the fetch, including the request and how the receiver will treat the response.
It provides the event.respondWith()
method, which allows us to provide a response to this fetch.
Instance properties
FetchEvent.request
readonly- : The
Request
that was received by the application.
- : The
FetchEvent.client
readonly- : Information about the downstream client that made the request.
FetchEvent.client.address
readonly- : A string representation of the IPv4 or IPv6 address of the downstream client.
FetchEvent.client.geo
readonly- : A geolocation dictionary corresponding to the IP address of the downstream client.
FetchEvent.client.tlsJA3MD5
readonly- : A string representation of the JA3 hash of the TLS ClientHello message.
FetchEvent.client.tlsCipherOpensslName
readonly- : A string representation of the cipher suite used to secure the client TLS connection.
FetchEvent.client.tlsProtocol
readonly- : A string representation of the TLS protocol version used to secure the client TLS connection.
FetchEvent.client.tlsClientCertificate
readonly- : An ArrayBuffer containing the raw client certificate in the mutual TLS handshake message. It is in PEM format. Returns an empty ArrayBuffer if this is not mTLS or available.
FetchEvent.client.tlsClientHello
readonly- : An ArrayBuffer containing the raw bytes sent by the client in the TLS ClientHello message.
FetchEvent.server
readonly- : Information about the server receiving the request for the Fastly Compute service.
FetchEvent.server.address
readonly- : A string representation of the IPv4 or IPv6 address of the server which received the request.
Instance methods
FetchEvent.respondWith()
- : Provide (a promise for) a response for this request.
FetchEvent.waitUntil()
- : Extends the lifetime of the event. Used to notify the host environment of tasks that extend beyond the returning of a response, such as streaming and caching.