Bug 20019 - Support subclassing ES6 Map
Support subclassing ES6 Map
Status: RESOLVED WORKSFORME
Product: WebAppsWG
Classification: Unclassified
Component: WebIDL
unspecified
PC Windows 3.1
: P2 normal
: ---
Assigned To: Cameron McCormack
public-webapps-bugzilla
:
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2012-11-20 12:45 UTC by Anne
Modified: 2015-02-19 11:33 UTC (History)
5 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Anne 2012-11-20 12:45:56 UTC
Context: http://lists.w3.org/Archives/Public/public-whatwg-archive/2012Nov/thread.html#msg220

URLQuery constraints: URLQuery represents an ordered list of name/value pairs and within that list duplicate names can occur. 

URLQuery API propopal: 

* new URLQuery(object) creates an ordered list of name/value pairs. We might want to support sequenced values in the object so you can create duplicate names.
* get(name) gets the value of the first matching name. 
* getAll(name) gets all values. 
* set(name, values) gets the matching items from the list and from that new list replaces their values one by one. If there's values left, appends new items to the list. If there's too few values, removes items from the list.
* add(name, values) ads new name/value pairs to the list.
* has(name) same semantics.
* delete(name [, value]) deletes all of name, or only removes those with a matching value.

name/value are also constrained in what they can contain. Percent-encoding happens for both. In addition URLQuery directly manipulates the query string of the associated URL object.

(I'm not entirely happy with the set() semantics above. Maybe initially we should only support setting a single value and require add() for duplicates?)
Comment 1 Tab Atkins Jr. 2012-11-20 18:23:18 UTC
Note that URLQuery isn't strictly a Map - it's a MultiMap, where one key can map to multiple values.

As such, we should probably check with tc39 to see if they have plans for a MultiMap API after Maps are fully adopted, and be consistent with that.

If they don't, we should at least make sure that the Map functions act appropriately for a single-value Map, and have additional functions for treating as a MultiMap (as you say, make set() take only a single value, while add() adds more values).
Comment 2 Tab Atkins Jr. 2012-11-20 18:23:57 UTC
Also, while we're doing this, we should check to see if there are any use-cases in the DOM for ES Sets, and add that at the same time.
Comment 3 Anne 2012-11-30 10:36:50 UTC
I changed my mind a little bit relative to comment 0 (API is also changing somewhat per discussion with Tab, see http://url.spec.whatwg.org/ for the latest thinking in a couple of hours). name/value will just be type constrained. The encoding and decoding of name/value will only happen when interfacing with the other object the ordered MultiMap needs to keep in sync with.
Comment 4 vic99999 2013-04-23 05:22:27 UTC
Seems,
for URLQuery API a "LinkedListMultiMap" is required.

- something similar to
http://google-collections.googlecode.com/svn/trunk/javadoc/com/google/common/collect/LinkedListMultimap.html

for proper iteration order when serializing
Comment 5 Anne 2015-02-19 11:33:01 UTC
This use case has been solved through other means.