@overlook/plugin-request
Version:
Overlook framework request plugin
49 lines (29 loc) • 2.68 kB
Markdown
[](https://www.npmjs.com/package/@overlook/plugin-request)
[](http://travis-ci.org/overlookjs/plugin-request)
[](https://david-dm.org/overlookjs/plugin-request)
[](https://david-dm.org/overlookjs/plugin-request)
[](https://greenkeeper.io/)
[](https://coveralls.io/r/overlookjs/plugin-request)
# Overlook framework request plugin
Part of the [Overlook framework](https://overlookjs.github.io/).
## Usage
This plugin exports two symbols, which are used as the most basic properties of Overlook request objects:
* `[REQ_TYPE]`
* `[PATH]`
For example, [@overlook/plugin-serve-http](https://www.npmjs.com/package/@overlook/plugin-serve-http) sets `req[REQ_TYPE]` to `'HTTP'` and records the request path as `req[PATH]`.
This plugin should not actually be used as a plugin - `Route.extend( requestPlugin )` adds no methods to the Route and so is pointless. This "plugin" only exists to export symbols.
## Versioning
This module follows [semver](https://semver.org/). Breaking changes will only be made in major version updates.
All active NodeJS release lines are supported (v10+ at time of writing). After a release line of NodeJS reaches end of life according to [Node's LTS schedule](https://nodejs.org/en/about/releases/), support for that version of Node may be dropped at any time, and this will not be considered a breaking change. Dropping support for a Node version will be made in a minor version update (e.g. 1.2.0 to 1.3.0). If you are using a Node version which is approaching end of life, pin your dependency of this module to patch updates only using tilde (`~`) e.g. `~1.2.3` to avoid breakages.
## Tests
Use `npm test` to run the tests. Use `npm run cover` to check coverage.
## Changelog
See [changelog.md](https://github.com/overlookjs/plugin-request/blob/master/changelog.md)
## Issues
If you discover a bug, please raise an issue on Github. https://github.com/overlookjs/plugin-request/issues
## Contribution
Pull requests are very welcome. Please:
* ensure all tests pass before submitting PR
* add tests for new features
* document new functionality/API additions in README
* do not add an entry to Changelog (Changelog is created when cutting releases)