@fastly/js-compute

@fastly/js-compute

JavaScript SDK and CLI for building JavaScript applications on Fastly Compute.

Getting Started

We recommend using the Fastly CLI to create, build, and deploy JavaScript Fastly Compute services, as described on the Fastly Developer Hub.

Detailed documentation for JavaScript Fastly Compute services is also available on Fastly Developer Hub.

Usage

JavaScript Examples

The Fastly Developer Hub has a collection of example JavaScript applications.

Here is a small example application:

/// <reference types="@fastly/js-compute" />

async function app(event) {
    const request = event.request;
    return new Response(`You made a request to ${request.url}`)
}

addEventListener("fetch", event => {
  event.respondWith(app(event));
});

API documentation

The API documentation for the JavaScript SDK is located at https://js-compute-reference-docs.edgecompute.app.

Security

If you find any security issues, see the Fastly Security Reporting Page or send an email to: [e-mail]

We plan to disclose any found security vulnerabilities per the GitHub security vulnerability guidance. Note that communications related to security issues in Fastly-maintained OSS as described here are distinct from Fastly security advisories.

Changelog

The changelog can be found here.

License

Apache-2.0 WITH LLVM-exception

Changelog

3.7.0 (2023-10-14)

Added

This release of @fastly/js-compute includes 4 new methods to the Backend class, which enable the Fastly Service to retrieve information about any backend, this is particularly useful for checking if the backend is “healthy”. (#523) (08f816a)

The new methods are:

• Backend.exists(name) - Check whether a backend with the given name exists for the Fastly Service.
• Backend.fromName(name) - Check whether a backend with the given name exists for the Fastly Service and if it does, then returns an instance of Backend for the given name.
• Backend.health(name) - Returns the health of the backend with the given name.
• Backend.prototype.toName() - Return the name for the Backend instance.

Fixed

• bring back support for build-time env vars (#691) (c044ac4)
• raise an error during wizening for async functions given to addEventListener (#689) (e6747a2)