Socket
Socket
Sign inDemoInstall

allow-methods

Package Overview
Dependencies
Maintainers
0
Versions
22
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

allow-methods

Express/connect middleware to handle 405 errors


Version published
Maintainers
0
Created
Source

Allow-Methods

Express/connect middleware to handle 405 errors, when a request method is not supported by your route or application.

Table of Contents

  • Requirements
  • Usage
  • Contributing
  • License

Requirements

This library requires the following to run:

Usage

Install with npm:

npm install allow-methods

Load the library into your code with a require call:

const allowMethods = require('allow-methods');

allowMethods will return a middleware function that will error if the request method does not match one of the allowed methods. The error will have message and status properties which you can use.

It accepts two arguments. Firstly, an array of allowed methods:

allowMethods(['get', 'head', 'post']);

Secondly (optionally) a message which will be used in the error if the request message does not match:

allowMethods(['get', 'head'], 'Unsupported method');

Route-level

const express = require('express');
const app = express();

app
    .route('/example')
    // Only requests with a GET/HEAD method will continue
    .all(allowMethods(['get', 'head']))
    // Define GET handler
    .get(function () { ... });

If you want to do something useful with the error, for example output a sensible JSON response, you will need to define an error handler for your application (after the route definition):

app.use(function (error, requst, response, next) {
    response.status(error.status || 500).send({
        message: error.message
    });
});

Application-level

const express = require('express');
const app = express();

// Only allow GET/HEAD methods across the entire application
app.use(allowMethods(['get', 'head']));

Contributing

The contributing guide is available here. All contributors must follow this library's code of conduct.

License

Licensed under the MIT license.
Copyright © 2015, Rowan Manning

Keywords

FAQs

Package last updated on 27 Jul 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
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc