qs-url

A url and querystring parsing library extend from fs library

Usage

const qsUrl = require('qs-url');
const url = 'http://www.bolin.site/user/?id=1&status=success#/user/info?name=lbl&userId=456';

const query1 = qsUrl.getQuery('', url); // {id: '1', status: 'success'}

const query2 = qsUrl.getQuery(['id'], url) // {id: '1'}

const query3 = qsUrl.getQuery('status', url) // success


// set baseUrl and parse it

qsUrl.setBaseUrl('http://www.bolin.site/user/?id=1&status=success#/user/info?name=lbl&userId=456')
const urlInfo = qsUrl.parseUrl();

expect(urlInfo).to.deep.equal({
    url: 'http://www.bolin.site/user/',
    query: {id: '1'},
    queryStr: 'id=1',
    hash: '/user/info',
    hashStr: '/user/info?name=lbl&userId=456',
    params: {name: 'lbl', userId: '456'},
    paramsStr: 'name=lbl&userId=456',
});

// do not pass url argument after set baseUrl
const query3 = qsUrl.getQuery('status') // success

APIs

url: 'http://www.bolin.site/user/?id=1&status=success#/user/info?name=lbl&userId=456'

API	arguments	return
parse	-	-
stringify	-	-
formats	-	-
getQuery	(string&array, [string&object])	object
addQuery	(object, [string&object])	string
removeQuery	(string&array, [string&object])	string
replaceQuery	(object, [string&object])	string
getParams	(string&array, [string&object])	object&string
addParams	(object, [string&object])	string
removeParams	(string&array, [string&object])	string
replaceParams	(object, [string&object])	string
getPath	([string&object])	string
getPathAndQuery	([string&object])	string
getPathAndHash	([string&object])	string
setBaseUrl	(string)	-
setBaseUrl	-	string
parseUrl	([string&object])	object

CHANGE LOG

1.1.1 - [ 2019-12-23 ]

[ M ] - 支持端口匹配 [ A ] - 添加parseUrl2方法解析url，返回正则匹配结果map

1.1.0 - [ 2019-09-30 ]

[ M ] - 修改底层URL匹配正则，在search与params的key-value中支持特殊字符 [ M ] - 修改对应的单元测试 [ M ] - 修改webpack打包配置，全局变量设置为this, 支持浏览器/node等使用，全部方法暴露到全局变量下

1.0.4 - [ 2019-05-07 ]

[ M ] - 升级babel到7.0+ [ M ] - 打包转译Object.assign