Socket
Socket
Sign inDemoInstall

fortune-http

Package Overview
Dependencies
8
Maintainers
2
Versions
48
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

fortune-http

HTTP implementation for Fortune.js.


Version published
Weekly downloads
996
decreased by-0.4%
Maintainers
2
Created
Weekly downloads
 

Readme

Source

Fortune HTTP

Build Status npm Version License

This is a HTTP implementation for Fortune.js, which includes default serializers for JSON, HTML, form encoded and form data. This module is required for other HTTP serializers.

$ npm install fortune-http --save

Usage

Consult the source code or the documentation website for more information.

// Use the Node.js core HTTP implementation.
const http = require('http')

// The alternative `uWS.http` implementation may be supported:
// const http = require('uws').http

const fortuneHTTP = require('fortune-http')

// Pass in a Fortune instance and an optional options object.
const listener = fortuneHTTP(fortuneInstance, options)

const server = http.createServer((request, response) =>
  listener(request, response)
  // Make sure to catch Promise rejections.
  .catch(error => {
    console.error(error.stack)
  }))

For use with middleware frameworks such as Express:

const express = require('express')
const fortuneHTTP = require('fortune-http')

const app = express()
const listener = fortuneHTTP(fortuneInstance, options)

// Make sure that the Fortune listener is last in the middleware stack,
// since it ends the response by default (this can be optionally disabled).
app.use((request, response) =>
  listener(request, response)
  .catch(error => { ... }))

Customization

The HTML serializer has some customization options.

  • prefix: a prefix to add to every route. Default: "" (empty string).
  • indexRoute: path to the index route. Default: "" (empty string).
  • injectHTML: passing this option as a String to the HTML serializer will include it in the response.

On record type field definitions:

  • inputOnly: on a record field definition, setting this property to true will mark it as an input only field. Combined with making the field non-enumerable, virtual inputs can be defined.
  • outputOnly: on a record field definition, setting this property to true will hide it from input.

The form serializers interpret a few special fields.

  • All payloads must include cookie values, prefixed with CSRF_ to prevent Cross-Site Request Forgery attacks.
  • The special field __method__ may be used to override the method, which may be valued by any method that Fortune.js accepts.

Demo

By installing the development dependencies, one can run the test instance locally:

$ npm i && npm run demo

License

This software is licensed under the MIT license.

Keywords

FAQs

Package last updated on 10 Feb 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc