Revision 1047410 of URLSearchParams.has()

Revision slug: Web/API/URLSearchParams/has
Revision title: URLSearchParams.has()
Revision id: 1047410
Created: Apr 26, 2016, 11:32:21 AM
Creator: rolfedh
Is current revision? Yes
Comment Editorial review. Minor edit for grammar and style.

Tags:

Revision Content

The has() method of the {{domxref("URLSearchParams")}} interface returns a {{jsxref("Boolean")}} that indicates whether a parameter with the specified name exists.

Syntax

var hasName = URLSearchParams.has(name)

Parameters

name: The name of the parameter to find.

Returns

A {{jsxref("Boolean")}}.

Example

let url = new URL('https://example.com?foo=1&bar=2');
let params = new URLSearchParams(url.search.slice(1));

params.has('bar') === true; //true

Specifications

Specification	Status	Comment
{{SpecName('URL', '#dom-urlsearchparams-has', "has()")}}	{{Spec2('URL')}}	Initial definition.

Browser compatibility

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
Basic support	{{CompatChrome(49.0)}}

Feature	Android	Android Webview	Firefox Mobile (Gecko)	Firefox OS	IE Mobile	Opera Mobile	Safari Mobile	Chrome for Android
Basic support	{{CompatNo}}	{{CompatChrome(49.0)}}						{{CompatChrome(49.0)}}

Revision Source

<p>{{ApiRef("URL API")}}{{SeeCompatTable}}&nbsp;</p>

<p>The <strong>has() </strong>method of the {{domxref("URLSearchParams")}} interface returns a {{jsxref("Boolean")}} that indicates whether a parameter with the specified name exists.</p>

<h2 id="Syntax">Syntax</h2>

<pre class="syntaxbox">
var <em>hasName</em> = URLSearchParams.has(<em>name</em>)</pre>

<h3 id="Parameters">Parameters</h3>

<dl>
 <dt>name</dt>
 <dd>The name of the parameter to find.</dd>
</dl>

<h3 id="Returns">Returns</h3>

<p>A {{jsxref("Boolean")}}.</p>

<h2 id="Example">Example</h2>

<pre class="brush: js">
let url = new URL('https://example.com?foo=1&amp;bar=2');
let params = new URLSearchParams(url.search.slice(1));

params.has('bar') === true; //true
</pre>

<h2 id="Specifications">Specifications</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('URL', '#dom-urlsearchparams-has', "has()")}}</td>
   <td>{{Spec2('URL')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility">Browser compatibility</h2>

<div>{{CompatibilityTable}}</div>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatChrome(49.0)}}</td>
   <td>&nbsp;</td>
   <td>&nbsp;</td>
   <td>&nbsp;</td>
   <td>&nbsp;</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Android Webview</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>Firefox OS</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
   <th>Chrome for Android</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatChrome(49.0)}}</td>
   <td>&nbsp;</td>
   <td>&nbsp;</td>
   <td>&nbsp;</td>
   <td>&nbsp;</td>
   <td>&nbsp;</td>
   <td>{{CompatChrome(49.0)}}</td>
  </tr>
 </tbody>
</table>
</div>

Revert to this revision