<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>23586</bug_id>
          
          <creation_ts>2013-10-21 18:35:03 +0000</creation_ts>
          <short_desc>Naming conflict for query</short_desc>
          <delta_ts>2013-11-01 17:32:21 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>WHATWG</product>
          <component>URL</component>
          <version>unspecified</version>
          <rep_platform>All</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>Unsorted</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Erik Arvidsson">erik.arvidsson</reporter>
          <assigned_to name="Anne">annevk</assigned_to>
          <cc>bkardell</cc>
    
    <cc>d</cc>
    
    <cc>ian</cc>
    
    <cc>mathias</cc>
    
    <cc>mike</cc>
    
    <cc>Ms2ger</cc>
          
          <qa_contact>sideshowbarker+urlspec</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>95029</commentid>
    <comment_count>0</comment_count>
    <who name="Erik Arvidsson">erik.arvidsson</who>
    <bug_when>2013-10-21 18:35:03 +0000</bug_when>
    <thetext>Both http://dom.spec.whatwg.org/#parentnode and http://url.spec.whatwg.org/#api defines a property named query.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95082</commentid>
    <comment_count>1</comment_count>
    <who name="Anne">annevk</who>
    <bug_when>2013-10-22 10:21:22 +0000</bug_when>
    <thetext>Wow, even with the same author we get clashes. Sad times.

I&apos;m not sure which one to rename.

Should we go for searchObj and URLSearch?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95118</commentid>
    <comment_count>2</comment_count>
    <who name="Erik Arvidsson">erik.arvidsson</who>
    <bug_when>2013-10-22 20:17:24 +0000</bug_when>
    <thetext>Maybe name the property urlQuery?

Another option is to not have a URL query property on HTMLAnchorElement nor HTMLTextAreaElement.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95129</commentid>
    <comment_count>3</comment_count>
    <who name="Domenic Denicola">d</who>
    <bug_when>2013-10-22 21:45:12 +0000</bug_when>
    <thetext>I am starting to like queryParams or queryPairs. (Or searchParams/searchPairs.)</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95131</commentid>
    <comment_count>4</comment_count>
    <who name="brian kardell">bkardell</who>
    <bug_when>2013-10-22 21:50:16 +0000</bug_when>
    <thetext>(In reply to Domenic Denicola from comment #3)
&gt; I am starting to like queryParams or queryPairs. (Or
&gt; searchParams/searchPairs.)

+1 queryParams ... intuitive, been used before in other languages/frameworks/documentation and still fairly short.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95137</commentid>
    <comment_count>5</comment_count>
    <who name="Erik Arvidsson">erik.arvidsson</who>
    <bug_when>2013-10-22 22:02:35 +0000</bug_when>
    <thetext>I&apos;m also fine with queryParams.

Should we rename URLQuery to QueryParams as well?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95172</commentid>
    <comment_count>6</comment_count>
    <who name="Anne">annevk</who>
    <bug_when>2013-10-23 10:43:41 +0000</bug_when>
    <thetext>Where has queryParams been used before? And yeah, if we go with that we should probably rename the interface.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95185</commentid>
    <comment_count>7</comment_count>
    <who name="brian kardell">bkardell</who>
    <bug_when>2013-10-23 12:49:25 +0000</bug_when>
    <thetext>(In reply to Anne from comment #6)
&gt; Where has queryParams been used before? And yeah, if we go with that we
&gt; should probably rename the interface.

Seems to be pretty common parlance among devs to me - i see it in code frequently in several languages.

some google searches show examples supporting...

https://www.google.com/search? q=%E2%80%9Dqueryparams%E2%80%9D

https://www.google.com/search? q=%E2%80%9Dqueryparams%E2%80% 9D+querystring

https://www.google.com/search? q=%E2%80%9Dqueryparams%E2%80%9D+url</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95684</commentid>
    <comment_count>8</comment_count>
    <who name="Anne">annevk</who>
    <bug_when>2013-11-01 15:33:09 +0000</bug_when>
    <thetext>I&apos;m still a bit torn. If we cannot use the actual proper term I think I somewhat prefer consistency with the existing API and either use searchObj or searchParams.

I&apos;m happy to be overruled though, it&apos;s not a big deal.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95685</commentid>
    <comment_count>9</comment_count>
    <who name="brian kardell">bkardell</who>
    <bug_when>2013-11-01 15:52:35 +0000</bug_when>
    <thetext>(In reply to Anne from comment #8)
&gt; I&apos;m still a bit torn. If we cannot use the actual proper term I think I
&gt; somewhat prefer consistency with the existing API and either use searchObj
&gt; or searchParams.
&gt; 
&gt; I&apos;m happy to be overruled though, it&apos;s not a big deal.


searchParams isn&apos;t so bad... where is that more consistent though?  

non-sequitur complaint on the platform in general: I hate that we have so many properties that begin with a potential verb and therefore seem like they might be a method.  Seems kinda bad because it blocks a potentially useful method name and leaves us in situations picking a less than ideal name.  Don&apos;t really see a great solution here for that, just mentioning that it bothers me :)</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95686</commentid>
    <comment_count>10</comment_count>
    <who name="Anne">annevk</who>
    <bug_when>2013-11-01 16:01:54 +0000</bug_when>
    <thetext>So my thinking is that either we have the short good name query and ignore search exists. Or we embrace that search exists and offer a classList-like companion. searchObj mostly stems from HTMLMediaElement src / srcObj (although they might name it srcObject).</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95690</commentid>
    <comment_count>11</comment_count>
    <who name="Erik Arvidsson">erik.arvidsson</who>
    <bug_when>2013-11-01 16:59:14 +0000</bug_when>
    <thetext>(In reply to Anne from comment #10)
&gt; So my thinking is that either we have the short good name query and ignore
&gt; search exists. Or we embrace that search exists and offer a classList-like
&gt; companion. searchObj mostly stems from HTMLMediaElement src / srcObj
&gt; (although they might name it srcObject).

I&apos;m fine with searchObject but not with searchObj. We should not name things &quot;obj&quot;. obj is fine for local variable names etc but we should not promote obj, doc, el, evt etc to APIs.

Other options include

{search,query}{List,Map,Object,Params}</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95693</commentid>
    <comment_count>12</comment_count>
    <who name="Anne">annevk</who>
    <bug_when>2013-11-01 17:09:58 +0000</bug_when>
    <thetext>Are you aware of srcdoc?

Anyway, I am cool with searchParams with as object URLSearchParams.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95697</commentid>
    <comment_count>13</comment_count>
    <who name="Anne">annevk</who>
    <bug_when>2013-11-01 17:32:21 +0000</bug_when>
    <thetext>https://github.com/whatwg/url/commit/0ca57a12e90099e00a0f142b7170d93fb11ab309</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>