HTMLAnchorElement: search プロパティ

HTMLAnchorElement.search プロパティは、クエリー文字列とも呼ばれる検索文字列、つまり '?' とその後に続く URL の引数の入った文字列です。

最新のブラウザーでは、URLSearchParams と URL.searchParams を提供して、クエリー文字列から引数を簡単に解析できるようにしています。

値

文字列です。

例

アンカーリンクから検索文字列を取得

js
// <a id="myAnchor" href="/ja/docs/HTMLAnchorElement?q=123"> 要素が文書内にあったとします
const anchor = document.getElementById("myAnchor");
anchor.search; // '?q=123' を返す

URLSearchParams を使用した高度な解釈

他にも、 URLSearchParams が使われる場面があります。

js
let params = new URLSearchParams(queryString);
let q = parseInt(params.get("q")); // 数値 123 を返す

仕様書

Specification
HTML Standard
# dom-hyperlink-search-dev

ブラウザーの互換性

BCD tables only load in the browser

関連情報