NodeJS - urlSearchParams.sort() 方法

---

---

NodeJS urlSearchParams.sort() 方法是 URLSearchParams 類的成員方法，用於對查詢字串中所有名稱-值對的名稱進行排序。排序使用穩定的排序演算法（即，具有相同名稱的名稱-值對之間的相對順序將被保留）。此方法按升序排序。

此方法返回 undefined，要獲取此方法的結果，請將排序後的查詢字串賦值給 toString() 方法。

URLSearchParams API 提供了訪問和讀取 URL 查詢的方法。此類也存在於全域性物件上。

語法

以下是NodeJS URLSearchParams.sort() 方法的語法

URLSearchParams.sort()

引數

此方法不接受任何引數。

返回值

此方法返回 undefined。

以下是一些示例，我們展示了在不同場景下 sort() 方法的使用

示例

如果我們將包含名稱-值對的查詢字串分配給NodeJS urlSearchParams.sort() 方法，它將按名稱對所有名稱-值對進行排序。

在下面的示例中，我們嘗試對輸入查詢字串中的名稱-值對進行排序。

const url = require('node:url');

const myUrl = new URL('https://tutorialspoint.tw?Monday=1&Thursday=4&Friday=5');
console.log("URL: " + myUrl.href);

const Params = new URLSearchParams('Monday=1&Thursday=4&Friday=5');
console.log("Query string: " + Params);

console.log(Params.sort());

console.log("The query string after sorting: " + Params.toString());

輸出

正如我們在下面的輸出中看到的，名稱-值對都按其名稱進行了排序。

URL: https://tutorialspoint.tw/?Monday=1&Thursday=4&Friday=5
Query string: Monday=1&Thursday=4&Friday=5
undefined
The query string after sorting: Friday=5&Monday=1&Thursday=4

示例

如果名稱-值對中名稱有多個出現，NodeJS sort() 方法將認為第一個出現的名稱應根據順序排在最前面。

在下面的程式中，我們嘗試對查詢字串中的名稱-值對進行排序。

const url = require('node:url');

const myUrl = new URL('https://tutorialspoint.tw?1=twoe&6=six&1=one&5=five');
console.log("URL: " + myUrl.href);

const Params = new URLSearchParams('1=two&6=six&1=one&5=five');
console.log("Query string: " + Params);

console.log(Params.sort());

console.log("The query string after sorting: " + Params.toString());

輸出

正如我們在下面的輸出中看到的，查詢字串中名稱“1”出現了多次，但是 sort() 方法認為名稱“1”的第一次出現應根據順序排在最前面。

URL: https://tutorialspoint.tw/?1=twoe&6=six&1=one&5=five
Query string: 1=two&6=six&1=one&5=five
undefined
The query string after sorting: 1=two&1=one&5=five&6=six

示例

sort() 方法將首先對整數進行排序，然後對特殊字元進行排序，最後對字母進行排序，排序規則根據 ASCII 排序順序。

在下面的示例中，輸入字串中名稱-值對的名稱以整數開頭，其中一些以特殊字元開頭。我們嘗試按名稱對名稱-值對進行排序。

const url = require('node:url');

const myUrl = new URL('https://tutorialspoint.tw?1=two&6=six&1=one&5=five');
console.log("URL: " + myUrl.href);

const Params = new URLSearchParams('`1=two&6=six&1=one&5=five');
console.log("Query string: " + Params);

console.log(Params.sort());

console.log("The query string after sorting: " + Params.toString());

輸出

正如我們在輸出中看到的，以整數開頭的名稱首先排序，然後是特殊字元。

URL: https://tutorialspoint.tw/?1=two&6=six&1=one&5=five
Query string: %601=two&6=six&1=one&5=five
Undefined
The query string after sorting: 1=one&5=five&6=six&%601=two