Brunobkr/llama.cpp_AlgMor24_github

1# finalhandler2 3[![NPM Version][npm-image]][npm-url]4[![NPM Downloads][downloads-image]][downloads-url]5[![Node.js Version][node-image]][node-url]6[![Build Status][github-actions-ci-image]][github-actions-ci-url]7[![Test Coverage][coveralls-image]][coveralls-url]8[![OpenSSF Scorecard Badge][ossf-scorecard-badge]][ossf-scorecard-visualizer]9 10Node.js function to invoke as the final step to respond to HTTP request.11 12## Installation13 14This is a [Node.js](https://nodejs.org/en/) module available through the15[npm registry](https://www.npmjs.com/). Installation is done using the16[`npm install` command](https://docs.npmjs.com/getting-started/installing-npm-packages-locally):17 18```sh19$ npm install finalhandler20```21 22## API23 24```js25const finalhandler = require('finalhandler')26```27 28### finalhandler(req, res, [options])29 30Returns function to be invoked as the final step for the given `req` and `res`.31This function is to be invoked as `fn(err)`. If `err` is falsy, the handler will32write out a 404 response to the `res`. If it is truthy, an error response will33be written out to the `res` or `res` will be terminated if a response has already34started.35 36When an error is written, the following information is added to the response:37 38  * The `res.statusCode` is set from `err.status` (or `err.statusCode`). If39    this value is outside the 4xx or 5xx range, it will be set to 500.40  * The `res.statusMessage` is set according to the status code.41  * The body will be the HTML of the status code message if `env` is42    `'production'`, otherwise will be `err.stack`.43  * Any headers specified in an `err.headers` object.44 45The final handler will also unpipe anything from `req` when it is invoked.46 47#### options.env48 49By default, the environment is determined by `NODE_ENV` variable, but it can be50overridden by this option.51 52#### options.onerror53 54Provide a function to be called with the `err` when it exists. Can be used for55writing errors to a central location without excessive function generation. Called56as `onerror(err, req, res)`.57 58## Examples59 60### always 40461 62```js63const finalhandler = require('finalhandler')64const http = require('http')65 66const server = http.createServer((req, res) => {67  const done = finalhandler(req, res)68  done()69})70 71server.listen(3000)72```73 74### perform simple action75 76```js77const finalhandler = require('finalhandler')78const fs = require('fs')79const http = require('http')80 81const server = http.createServer((req, res) => {82  const done = finalhandler(req, res)83 84  fs.readFile('index.html', (err, buf) => {85    if (err) return done(err)86    res.setHeader('Content-Type', 'text/html')87    res.end(buf)88  })89})90 91server.listen(3000)92```93 94### use with middleware-style functions95 96```js97const finalhandler = require('finalhandler')98const http = require('http')99const serveStatic = require('serve-static')100 101const serve = serveStatic('public')102 103const server = http.createServer((req, res) => {104  const done = finalhandler(req, res)105  serve(req, res, done)106})107 108server.listen(3000)109```110 111### keep log of all errors112 113```js114const finalhandler = require('finalhandler')115const fs = require('fs')116const http = require('http')117 118const server = http.createServer((req, res) => {119  const done = finalhandler(req, res, { onerror: logerror })120 121  fs.readFile('index.html', (err, buf) => {122    if (err) return done(err)123    res.setHeader('Content-Type', 'text/html')124    res.end(buf)125  })126})127 128server.listen(3000)129 130function logerror (err) {131  console.error(err.stack || err.toString())132}133```134 135## License136 137[MIT](LICENSE)138 139[npm-image]: https://img.shields.io/npm/v/finalhandler.svg140[npm-url]: https://npmjs.org/package/finalhandler141[node-image]: https://img.shields.io/node/v/finalhandler.svg142[node-url]: https://nodejs.org/en/download143[coveralls-image]: https://img.shields.io/coveralls/pillarjs/finalhandler.svg144[coveralls-url]: https://coveralls.io/r/pillarjs/finalhandler?branch=master145[downloads-image]: https://img.shields.io/npm/dm/finalhandler.svg146[downloads-url]: https://npmjs.org/package/finalhandler147[github-actions-ci-image]: https://github.com/pillarjs/finalhandler/actions/workflows/ci.yml/badge.svg148[github-actions-ci-url]: https://github.com/pillarjs/finalhandler/actions/workflows/ci.yml149[ossf-scorecard-badge]: https://api.scorecard.dev/projects/github.com/pillarjs/finalhandler/badge150[ossf-scorecard-visualizer]: https://ossf.github.io/scorecard-visualizer/#/projects/github.com/pillarjs/finalhandler