大网数据广告活动
Web 标准与前端开发

HTMLAreaElement: search property

· 52CE 我爱测

The **`search`** property of the HTMLAreaElement interface is a search string, also called a _query string_, that is a string containing a `"?"` followed by the parameters of the `<area>` element's `href`. If the URL does not have a search query, this property contains an empty s

HTML DOM

The search property of the HTMLAreaElement interface is a search string, also called a query string, that is a string containing a "?" followed by the parameters of the <area> element's href. If the URL does not have a search query, this property contains an empty string, "".

This property can be set to change the query string of the URL. When setting, a single "?" prefix is added to the provided value, if not already present. Setting it to "" removes the query string.

The query is Percent-encoding when setting but not percent-decoded when reading.

Modern browsers provide URLSearchParams and URL.searchParams to make it easy to parse out the parameters from the query string.

See URL.search for more information.

Value

A string.

Examples

Getting the search string from an area link

// An <area id="myArea" href="/en-US/docs/HTMLAreaElement?q=123"> element is in the document
const area = document.getElementById("myArea");
area.search; // returns '?q=123'

Advanced parsing using URLSearchParams

Alternatively, URLSearchParams can be used:

let params = new URLSearchParams(queryString);
let q = parseInt(params.get("q"), 10); // returns the number 123

Specifications

Browser compatibility

See also

  • The HTMLAreaElement interface it belongs to.

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。