What does 'extended' mean in express 4.0?
Asked Answered
N

3

129

I'm using express and also body-parser in my app.

app.use(bodyParser.urlencoded({ extended: false }));

But, What does 'extended' mean in express 4.0?

I found this

extended - parse extended syntax with the qs module.

However, I still can't understrand what it means.

Nymphomania answered 30/4, 2015 at 6:42 Comment(0)
A
192

If extended is false, you can not post "nested object"

person[name] = 'cw'

// Nested Object = { person: { name: cw } }

If extended is true, you can do whatever way that you like.

Aronow answered 29/9, 2016 at 20:53 Comment(1)
#29175965 and #29961264Nariko
T
153

When extended property is set to true, the URL-encoded data will be parsed with the qs library.

On the contrary,

when extended property is set to false, the URL-encoded data will instead be parsed with the query-string library.


The differences between parsing with `qs library` vs `querystring library`

  • qs library allows you to create a nested object from your query string.

      var qs = require("qs")
      var result = qs.parse("person[name]=bobby&person[age]=3")
      console.log(result) // { person: { name: 'bobby', age: '3' } }
    
  • query-string library does not support creating a nested object from your query string.

      var queryString = require("query-string")
      var result = queryString.parse("person[name]=bobby&person[age]=3")
      console.log(result) // { 'person[age]': '3', 'person[name]': 'bobby' }
    

  • qs library will not filter out '?' from the query string.

      var qs = require("qs")
      var result = qs.parse("?a=b")
      console.log(result) // { '?a': 'b' }
    

  • query-string library will filter out '?' from the query string.

      var queryString = require("query-string")
      var result = queryString.parse("?a=b")
      console.log(result) // { a: 'b' }
    

app.use(bodyParser.urlencoded({ extended: true })) // for parsing application/x-www-form-urlencoded

For more information, you may refer to Leonid Beschastny's answer.

Tenney answered 15/8, 2017 at 9:48 Comment(1)
#29961264Nariko
H
25

From the Body-Parser docs:

A new body object containing the parsed data is populated on the request object after the middleware (i.e. req.body). This object will contain key-value pairs, where the value can be a string or array (when extended is false), or any type (when extended is true).

And

The extended option allows to choose between parsing the URL-encoded data with the querystring library (when false) or the qs library (when true). The "extended" syntax allows for rich objects and arrays to be encoded into the URL-encoded format, allowing for a JSON-like experience with URL-encoded. For more information, please see the qs library.

Basically extended allows you to parse full objects.

Body Parser: Url Encoded

Hasp answered 30/4, 2015 at 6:48 Comment(0)

© 2022 - 2024 — McMap. All rights reserved.