http-compress

Compress HTTP response, supported Web standard compression methods

Packages

The package supports multiple platforms.

deno.land/x - https://deno.land/x/http_compress/mod.ts
npm - @httpland/http-compress

Compress with handler

Takes a handler and returns a handler with the response body compressed.

import { withCompress } from "https://deno.land/x/http_compress@$VERSION/mod.ts";

function handler(req: Request): Response {
  return new Response("Huge content");
}
Deno.serve(withCompress(handler));

Filter compression targets

You have complete control over what is compressed.

Various factors such as content length, media type, CPU usage, etc. can be used as filtering criteria.

The filter field is a function that takes a boolean. If true, responses containing that content will be compressed.

By default, only content larger than 10kb will be compressed.

The following example compresses when the content is more than 10kb, the media type is text/html, and request method is GET.

import { withCompress } from "https://deno.land/x/http_compress@$VERSION/mod.ts";

const handler = withCompress(() => new Response("Huge content"), {
  filter: (content, { request, response }) => {
    return 1024_0 < content.byteLength && // 10kb
      request.method === "GET" &&
      response.headers.get("Content-Type") === "text/html";
  },
});
Deno.serve(handler);

Spec

Create a new Response object with the compressed value of the response body.

No destructive changes are made to the original Response object.

For the Response header, the following fields may be added:

Content-Encoding
Vary

Definition of Terms

Handler - It is a function that takes a Request object as its first argument and returns a Response or Promise<Response> object.
```
type Handler = (request: Request) => Promise<Response> | Response;
```

License

Released under the MIT license