Skip to content

Commit

Permalink
Add value argument to URLSearchParams's has() and delete()
Browse files Browse the repository at this point in the history
  • Loading branch information
annevk committed May 5, 2023
1 parent ae3c28b commit 81412b3
Showing 1 changed file with 46 additions and 9 deletions.
55 changes: 46 additions & 9 deletions url.bs
Expand Up @@ -3700,10 +3700,10 @@ interface URLSearchParams {
readonly attribute unsigned long size;

undefined append(USVString name, USVString value);
undefined delete(USVString name);
undefined delete(USVString name, optional USVString value);
USVString? get(USVString name);
sequence<USVString> getAll(USVString name);
boolean has(USVString name);
boolean has(USVString name, optional USVString value);
undefined set(USVString name, USVString value);

undefined sort();
Expand Down Expand Up @@ -3761,8 +3761,9 @@ console.log(url.searchParams.get('b')); // "~"</code></pre>
the potential to change that object's <a for=url>path</a> in a manner equivalent to the {{URL}}
object's {{URL/search}} and {{URL/hash}} setters.

<div algorithm>
<p>To <dfn for=URLSearchParams oldids=concept-urlsearchparams-new>initialize</dfn> a
{{URLSearchParams}} object <var>query</var> with <var>init</var>, run these steps:
{{URLSearchParams}} object <var>query</var> with <var>init</var>:

<ol>
<li>
Expand Down Expand Up @@ -3791,9 +3792,11 @@ object's {{URL/search}} and {{URL/hash}} setters.
<a lt="urlencoded string parser">parsing</a> <var>init</var>.
</ol>
</ol>
</div>

<div algorithm>
<p>To <dfn for=URLSearchParams id=concept-urlsearchparams-update>update</dfn> a {{URLSearchParams}}
object <var>query</var>, run these steps:
object <var>query</var>:

<ol>
<li><p>If <var>query</var>'s <a for=URLSearchParams>URL object</a> is null, then return.
Expand All @@ -3811,7 +3814,9 @@ object <var>query</var>, run these steps:
<a>potentially strip trailing spaces from an opaque path</a> with <var>query</var>'s
<a for=URLSearchParams>URL object</a>.
</ol>
</div>

<div algorithm>
<p>The
<dfn constructor for=URLSearchParams lt="URLSearchParams(init)"><code>new URLSearchParams(<var>init</var>)</code></dfn>
constructor steps are:</p>
Expand All @@ -3822,10 +3827,14 @@ constructor steps are:</p>

<li><p><a for=URLSearchParams>Initialize</a> <a>this</a> with <var>init</var>.
</ol>
</div>

<div algorithm>
<p>The <dfn attribute for=URLSearchParams><code>size</code></dfn> getter steps are to return
<a>this</a>'s <a for=URLSearchParams>list</a>'s <a for=list>size</a>.
</div>

<div algorithm>
<p>The <dfn method for=URLSearchParams><code>append(<var>name</var>, <var>value</var>)</code></dfn>
method steps are:

Expand All @@ -3835,28 +3844,52 @@ method steps are:

<li><p><a for=URLSearchParams>Update</a> <a>this</a>.
</ol>
</div>

<p>The <dfn method for=URLSearchParams><code>delete(<var>name</var>)</code></dfn> method steps are:
<div algorithm>
<p>The <dfn method for=URLSearchParams><code>delete(<var>name</var>, <var>value</var>)</code></dfn>
method steps are:

<ol>
<li><p><a for=list>Remove</a> all <a for=/>tuples</a> whose name is <var>name</var> from
<li><p>If <var>value</var> is given, then <a for=list>remove</a> all <a for=/>tuples</a> whose name
is <var>name</var> and value is <var>value</var> from <a>this</a>'s
<a for=URLSearchParams>list</a>.

<li><p>Otherwise, <a for=list>remove</a> all <a for=/>tuples</a> whose name is <var>name</var> from
<a>this</a>'s <a for=URLSearchParams>list</a>.

<li><p><a for=URLSearchParams>Update</a> <a>this</a>.
</ol>
</div>

<div algorithm>
<p>The <dfn method for=URLSearchParams><code>get(<var>name</var>)</code></dfn> method steps are to
return the value of the first <a for=/>tuple</a> whose name is <var>name</var> in <a>this</a>'s
<a for=URLSearchParams>list</a>, if there is such a <a for=/>tuple</a>; otherwise null.
</div>

<div algorithm>
<p>The <dfn method for=URLSearchParams><code>getAll(<var>name</var>)</code></dfn> method steps are
to return the values of all <a for=/>tuples</a> whose name is <var>name</var> in <a>this</a>'s
<a for=URLSearchParams>list</a>, in list order; otherwise the empty sequence.
</div>

<div algorithm>
<p>The <dfn method for=URLSearchParams><code>has(<var>name</var>, <var>value</var>)</code></dfn>
method steps are:

<ol>
<li><p>If <var>value</var> is given and there is a <a for=/>tuple</a> whose name is <var>name</var>
and value is <var>value</var> in <a>this</a>'s <a for=URLSearchParams>list</a>, then return true.

<p>The <dfn method for=URLSearchParams><code>has(<var>name</var>)</code></dfn> method steps are to
return true if there is a <a for=/>tuple</a> whose name is <var>name</var> in <a>this</a>'s
<a for=URLSearchParams>list</a>; otherwise false.
<li><p>If <var>value</var> is not given and there is a <a for=/>tuple</a> whose name is
<var>name</var> in <a>this</a>'s <a for=URLSearchParams>list</a>, then return true.

<li><p>Return false.
</ol>
</div>

<div algorithm>
<p>The <dfn method for=URLSearchParams><code>set(<var>name</var>, <var>value</var>)</code></dfn>
method steps are:

Expand All @@ -3870,6 +3903,7 @@ method steps are:

<li><p><a for=URLSearchParams>Update</a> <a>this</a>.
</ol>
</div>

<hr>

Expand All @@ -3891,6 +3925,7 @@ const sorted = new URLSearchParams(url.search)
sorted.sort()</code></pre>
</div>

<div algorithm>
<p>The <dfn method for=URLSearchParams><code>sort()</code></dfn> method steps are:

<ol>
Expand All @@ -3900,6 +3935,7 @@ sorted.sort()</code></pre>

<li><p><a for=URLSearchParams>Update</a> <a>this</a>.
</ol>
</div>

<hr>

Expand Down Expand Up @@ -3954,6 +3990,7 @@ Bobby Holley,
Boris Zbarsky,
Brad Hill,
Brandon Ross,
Cailyn Hansen,
Chris Dumez,
Chris Rebert,
Corey Farwell,
Expand Down

0 comments on commit 81412b3

Please sign in to comment.