# hijackresponse

> Hijack HttpResponses

Latest version **5.0.0** (published 2020-09-28) · ISC license · 0 weekly downloads

## Install

```sh
npm install hijackresponse
pnpm add hijackresponse
yarn add hijackresponse
bun add hijackresponse
```

## Health

**Score 33/100 (F)** — status: abandoned.

Positive: has types package; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 5.0.0 |
| Published | 2020-09-28 |
| First published | 2015-09-22 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | separate (@types/hijackresponse) |
| Module format | CommonJS |
| Node | >=8.0.0 |
| Dependencies | 0 |
| Unpacked size | 20.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 16 |
| Author | Gustav Nikolaj |
| Maintainers | papandreou, gustavnikolaj |

## Links

- npm: https://www.npmjs.com/package/hijackresponse
- Repository: https://github.com/gustavnikolaj/hijackresponse
- Issues: https://github.com/gustavnikolaj/hijackresponse/issues
- npm.io page: https://npm.io/package/hijackresponse

## Recent versions

- 5.0.0 (latest) — 2020-09-28
- 5.0.0-rc.2 — 2020-09-25
- 5.0.0-rc.1 — 2020-09-22
- 4.0.1 — 2020-09-14
- 4.0.0 — 2019-03-04
- 3.0.0 — 2017-04-25
- 2.0.1 — 2016-12-02
- 2.0.0 — 2016-08-05
- 1.1.0 — 2016-04-15
- 1.0.4 — 2016-03-30
- 1.0.3 — 2016-02-18
- 1.0.2 — 2015-09-25
- 1.0.1 — 2015-09-23
- 1.0.0 — 2015-09-23
- 0.0.2 — 2015-09-22
- … 1 more at https://npm.io/package/hijackresponse/versions

## README

# hijackresponse

[![npm version](https://badge.fury.io/js/hijackresponse.svg)](https://www.npmjs.com/package/hijackresponse)
[![Build Status](https://travis-ci.org/gustavnikolaj/hijackresponse.svg)](https://travis-ci.org/gustavnikolaj/hijackresponse)
[![Coverage Status](https://coveralls.io/repos/gustavnikolaj/hijackresponse/badge.svg?branch=master&service=github)](https://coveralls.io/github/gustavnikolaj/hijackresponse?branch=master)
[![Dependency Status](https://david-dm.org/gustavnikolaj/hijackresponse.svg)](https://david-dm.org/gustavnikolaj/hijackresponse)

Module that allows you to rewrite HTTP responses from middleware further down
the stack, such as static providers, HTTP proxies etc.

Requires node v8 or later.

This module is the spiritual successor to
[express-hijackresponse](https://github.com/papandreou/express-hijackresponse)
attempting to solve the same goals. The differences from the original module are
primarily that the API is slightly different, there's no direct coupling to
express and it supports streams2.

It's mostly useful for content filters. The original use case is injecting an
inline JavaScript into all HTML responses in
[LiveStyle](https://github.com/One-com/livestyle). It is also used in a series
of transpiler and preprocessing middleware:

- [express-compiless](https://github.com/papandreou/express-compiless)
- [express-processimage](https://github.com/papandreou/express-processimage)
- [express-extractheaders](https://github.com/papandreou/express-extractheaders)
- [express-autoprefixer](https://github.com/gustavnikolaj/express-autoprefixer)

## Installation

```
$ npm install hijackresponse
```

## Usage

```js
var express = require("express");
var hijackResponse = require("hijackresponse");

var app = express();

app.use((req, res, next) => {
  hijackResponse(res, next).then(({ readable, writable }) => {
    // Don't hijack HTML responses:
    if (/^text\/html/.test(res.getHeader("Content-Type"))) {
      return readable.pipe(writable);
    }

    res.setHeader("X-Hijacked", "yes!");
    res.removeHeader("Content-Length");

    readable.pipe(transformStream).pipe(writable);
  });
});
```

## API

### Function `hijackResponse()`

```
hijackResponse(res[, cb]) => Promise<HijackedReponse>
```

The `hijackResponse` function takes one required argument - the response object
which is the target of the hijacking. The second optional argument, is a
callback to be called when the hijacking preparations are done; this will mostly
be used when you are working with express. You can also decide to call the
callback afterwards if you prefer. The following two examples are equivalent:

```js
app.use((req, res, next) => {
  hijackResponse(res, next).then(() => { /* ... */});
});

app.use((req, res, next) => {
  hijackResponse(res).then(() => { /* ... */});
  next();
});
```

The first example is easier to work with when you are working with async/await:

```js
// Using express-promise-router or equivalent

app.use(async (req, res, next) => {
  const hijackedResponse = await hijackResponse(res, next);

  // ... do something with the hijacked reponse.
})
```

### Object `hijackedResponse`

```
{
  readable: NodeJS ReadableStream,
  writable: NodeJS Writable,
  destroyAndRestore: Function
}
```

The resolution value of the Promise returned from calling `hijackResponse`.

- `readable` is a readable stream containing the captured response body.
- `writable` is a writable stream which will be sent to the client.
- `destroyAndRestore` is a function that destroys the readable stream, and
  restores the original res.

Everything written to `res` in other handlers are captured, so if you want to
delegate to the express errorhandler you need to call `destroyAndRestore` before
doing so. Calling `destroyAndRestore` will undo the hijack, and destroy the `readable`
stream, meaning that all data written to it so far is discarded.

```js
app.use((req, res, next) => {
  hijackResponse(res, next).then((hijackedResponse) => {
    hijackedResponse.destroyAndRestore();
    return next(new Error('Something bad happened'));
  });
});
```

If you don't call `destroyAndRestore` before passing the error to next, the
errorhandlers output will become available on the `readable`-stream instead of
being sent to the client as intended.

## License

This module is published under the ISC License. See the `LICENCE` file for
additional details.

---
_Source: https://npm.io/package/hijackresponse · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._