# restify-cors-middleware2

> CORS middleware with full W3C spec support

Latest version **2.2.1** (published 2023-02-27) · MIT license · 0 weekly downloads

## Install

```sh
npm install restify-cors-middleware2
pnpm add restify-cors-middleware2
yarn add restify-cors-middleware2
bun add restify-cors-middleware2
```

## Health

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

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

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.2.1 |
| Published | 2023-02-27 |
| First published | 2019-09-04 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 12.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 9 |
| Author | Datatrac Corporation |
| Maintainers | jimgroks |
| Keywords | restify, cors, cross origin, headers |

## Links

- npm: https://www.npmjs.com/package/restify-cors-middleware2
- Repository: https://github.com/DatatracCorporation/restify-cors-middleware
- Homepage: https://github.com/DatatracCorporation/restify-cors-middleware#readme
- Issues: https://github.com/DatatracCorporation/restify-cors-middleware/issues
- npm.io page: https://npm.io/package/restify-cors-middleware2

## Dependencies (1)

- [assert-plus](https://npm.io/package/assert-plus.md) ^1.0.0

## Recent versions

- 2.2.1 (latest) — 2023-02-27
- 2.2.0 — 2022-12-05
- 2.1.2 — 2020-12-03
- 2.1.1 — 2020-09-20
- 2.1.0 — 2020-06-06
- 2.0.0 — 2019-09-04
- 2.0.0-rc.1 — 2019-09-04

## README

# restify-cors-middleware2

> CORS middleware with full [W3C spec](https://www.w3.org/TR/cors/) support.

[![NPM](http://img.shields.io/npm/v/restify-cors-middleware2.svg?style=flat)](https://npmjs.org/package/restify-cors-middleware2)
[![License](http://img.shields.io/npm/l/restify-cors-middleware2.svg?style=flat)](https://github.com/DatatracCorporation/restify-cors-middleware2)

[![Build Status](http://img.shields.io/travis/DatatracCorporation/restify-cors-middleware2.svg?style=flat)](http://travis-ci.org/DatatracCorporation/restify-cors-middleware2)
[![Dependencies](http://img.shields.io/david/DatatracCorporation/restify-cors-middleware2.svg?style=flat)](https://david-dm.org/DatatracCorporation/restify-cors-middleware2)
[![Dev dependencies](http://img.shields.io/david/dev/DatatracCorporation/restify-cors-middleware2.svg?style=flat)](https://david-dm.org/DatatracCorporation/restify-cors-middleware2)
[![Peer dependencies](http://img.shields.io/david/peer/DatatracCorporation/restify-cors-middleware2.svg?style=flat)](https://david-dm.org/DatatracCorporation/restify-cors-middleware2)
[![Known Vulnerabilities](https://snyk.io/package/npm/restify-cors-middleware2/badge.svg)](https://snyk.io/package/npm/restify-cors-middleware2)

[![JavaScript Style Guide](https://cdn.rawgit.com/feross/standard/master/badge.svg)](https://github.com/feross/standard)

## Setup
```sh
$ npm install restify-cors-middleware2 --save
```

## Usage

```js
const corsMiddleware = require('restify-cors-middleware2')

const cors = corsMiddleware({
  preflightMaxAge: 5, //Optional
  origins: ['http://api.myapp.com', 'http://web.myapp.com'],
  allowHeaders: ['API-Token'],
  exposeHeaders: ['API-Token-Expiry']
})

server.pre(cors.preflight)
server.use(cors.actual)
```

## Allowed origins

You can specify the full list of domains and subdomains allowed in your application, using strings or regular expressions.

```js
origins: [
  'http://myapp.com',
  'http://*.myapp.com',
  /^https?:\/\/myapp.com(:[\d]+)?$/
]
```

For added security, this middleware sets `Access-Control-Allow-Origin` to the origin that matched, not the configured wildcard.
This means callers won't know about other domains that are supported.

Setting `origins: ['*']` is also valid, although it comes with obvious security implications. Note that it will still return a customised response (matching Origin), so any caching layer (reverse proxy or CDN) will grow in size accordingly.

By default, credentials are not allowed for the `*` origin.  This can be
overridden with the `allowCredentialsAllOrigins` option.

## Troubleshooting

As per the spec, requests without an `Origin` will not receive any CORS headers. Requests with a matching `Origin` will receive the appropriate response headers. Always be careful that any reverse proxies (e.g. Varnish) vary their cache depending on the origin, so you don't serve CORS headers to the wrong request.

## Compliance to the spec

See [unit tests](https://github.com/DatatracCorporation/restify-cors-middleware2/tree/master/test) for examples of preflight and actual requests.

## TypeScript declaration file support

A basic declaration file has been added (thanks to Dane Horak), but we
don't use TypeScript locally, so we have not validated it.  Let us know
if there is more that can be added.

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