parsePathname(string)

• Core
  • m
  • m.render
  • m.mount
  • m.route
  • m.request
  • m.jsonp
  • m.parseQueryString
  • m.buildQueryString
  • m.buildPathname
  • m.parsePathname
    • Description
    • Signature
    • How it works
  • m.trust
  • m.fragment
  • m.redraw
  • Promise
• Optional
  • Stream
• Tooling
  • Ospec

Description

Turns a string of the form /path/user?a=1&b=2 to an object

var object = m.parsePathname("/path/user?a=1&b=2")
// {path: "/path/user", params: {a: "1", b: "2"}}

Signature

object = m.parsePathname(string)

How to read signatures

How it works

The m.parsePathname method creates an object from a path with a possible query string. It is useful for parsing a local path name into its parts, and it's what m.route uses internally to normalize paths to later match them. It uses m.parseQueryString to parse the query parameters into an object.

var data = m.parsePathname("/path/user?a=hello&b=world")

// data.path is "/path/user"
// data.params is {a: "hello", b: "world"}

General-purpose URL parsing

The method is called parsePathname because it applies to pathnames. If you want a general-purpose URL parser, you should use the global URL class instead.