vite-plugin-fastly-js-compute

Vite plugin for Fastly Compute with vitest.

• Provide Fastly Compute global variables/classes which are defined inside fastly runtime
• Resolve namespaced imports like fastly:xxx

Requirements

• node.js (prefer version 18.19 or later)

Installation

yarn:

yarn add -D vite-plugin-fastly-js-compute

npm:

npm install -D vite-plugin-fastly-js-compute

Usage / Example

This package supports TypeScript ESM style.

ESM:

// vitest.config.ts
/// <reference types="vitest" />
import { defineConfig } from "vitest/config";
import fastlyCompute from "vite-plugin-fastly-js-compute";

export default defineConfig({
  plugins: [fastlyCompute()],
  test: {
    ...
  },
});

Important Notice

Fastly Compute supports WebCrypto module partially so this package will do polyfill as the same. However, WebCrypto became a stable feature from node.js 20, then globalThis.crypto object exists and could not overwrite it.

This means crypto related feature implementations are different between nodejs 20 and Fastly Compute runtime. If you write tests and runs in nodejs 20, crypto related tests will be succeeded unexpectedly.

Then vite-plugin-fastly-js-compute provides global variable __fastlyComputeNodeDefaultCrypto which indicates crypto is polyfill-ed or not, you can switch some test cases to prevent errors:

describe("Some Test", () => {
  // Run tests only crypto is polyfill-ed - nodejs 18.x
  it.runIf(!globalThis.__fastlyComputeNodeDefaultCrypto)("Crypto-related test", () => {
      ...Some assertions here
  });
});

Contribution

• Fork this repository
• Customize / Fix problem
• Send PR :-)
• Or feel free to create issues for us. We'll look into it

Author

Yoshiaki Sugimoto sugimoto@wnotes.net

License

MIT