URLSearchParams: toString() 方法

Baseline 已廣泛支援

此功能已成熟,可跨多種裝置和瀏覽器版本工作。它自 ⁨2018 年 4 月⁩ 起已在所有瀏覽器中可用。

注意:此功能在 Web Workers 中可用。

URLSearchParams 介面的 toString() 方法返回一個適合用於 URL 中的查詢字串。

注意: 此方法返回的查詢字串不包含問號。這與 Location.searchHTMLAnchorElement.searchURL.search 不同,後者都包含問號。

語法

js
toString()

引數

無。

返回值

返回一個不帶問號的字串。如果未設定任何搜尋引數,則返回一個空字串。屬於 application/x-www-form-urlencoded 百分比編碼集中的字元(包含除 ASCII 字母數字、*-._ 之外的所有碼點)會被進行百分比編碼,且 U+0020 SPACE 會被編碼為 +

示例

js
const url = new URL("https://example.com?foo=1&bar=2");
const params = new URLSearchParams(url.search);

// Add a second foo parameter.
params.append("foo", 4);
console.log(params.toString()); // Prints 'foo=1&bar=2&foo=4'

規範

規範
URL
# urlsearchparams-stringification-behavior

瀏覽器相容性

另見