---
title: URLSearchParams.get()
slug: Web/API/URLSearchParams/get
translation_of: Web/API/URLSearchParams/get
---
<p>{{ApiRef("URL API")}}</p>

<p>{{domxref("URLSearchParams")}} 接口的<strong>get()</strong>方法返回第一个与搜索参数对应的值<strong>。</strong></p>

<h2 id="语法">语法</h2>

<pre class="syntaxbox">URLSearchParams.get(name)</pre>

<h3 id="参数">参数</h3>

<dl>
 <dt>键名</dt>
 <dd>将要返回的参数的键名。</dd>
</dl>

<h3 id="返回值">返回值</h3>

<p>返回一个 {{domxref("USVString")}} ；如果没找到，返回 <code><strong>null</strong></code>.</p>

<h2 id="示例">示例</h2>

<p>如果一个页面的URL是 <code>https://example.com/?name=Jonathan&amp;age=18</code> ，你可以这样解析参数“name”和“age”:</p>

<pre class="default prettyprint prettyprinted"><code>let params = new URLSearchParams(document.location.search.substring(1));
let name = params.get("name")<span class="kwd">; // is the string "Jonathan"
</span>let age = parseInt(params.get("age"), 10<span class="kwd">); // is the number 18</span></code>
</pre>

<p>查找一个不存在的键名则返回 <code><strong>null</strong></code>:</p>

<pre><code>let address = params.get("address"); // null</code></pre>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">规范</th>
   <th scope="col">状态</th>
   <th scope="col">说明</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('URL', '#dom-urlsearchparams-get', "get()")}}</td>
   <td>{{Spec2('URL')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>

<div>


<p>{{Compat("api.URLSearchParams.get")}}</p>
</div>