content icon indicating copy to clipboard operation
content copied to clipboard

Published 20 hours ago • verified publisher icon mdn

[ON HOLD][JS] Array.fromAsync()

Open hamishwillee opened this issue 3 years ago • 4 comments

Acceptance Criteria

  • [ ] The listed features are documented sufficiently on MDN
  • [ ] BCD is updated
  • [ ] Interactive example and data repos are updated if appropriate
  • [ ] The content has been reviewed as needed

For folks helping with Firefox related documentation

  • [ ] Set bugs to dev-doc-complete
  • [ ] Add entry to Firefox release notes if feature is enabled in release
  • [ ] Add entry to Firefox experimental features page if feature is not yet enabled in release

Features to document

On hold:

  • Bugzilla1795452 implemented this behind a preference enable-array-grouping on nightly (only) and disabled that pref by default.
  • It is the opinion of the developer that we are probably best holding off documenting for now (give them time to discover any name conflicts / webcompat issues).
  • Trigger would this being released: https://bugzilla.mozilla.org/show_bug.cgi?id=1795816

Other information at time of writing:

  • No other known implementation - v8's bug is here, with no activity; couldn't one for JSC.
  • This is as TS3 (as of 2022 September.
  • The explainer is out of date (at least w.r.t. fact it says still at TS1.

Related Gecko bugs

  • Meta: https://bugzilla.mozilla.org/show_bug.cgi?id=1746209
    • FF108 implementation "nightly disabled pref": https://bugzilla.mozilla.org/show_bug.cgi?id=1795452
    • Shipping: https://bugzilla.mozilla.org/show_bug.cgi?id=1795816

Other

  • [ ] Check content open issues to see if any pertain to the subject matter. If there are any that can be closed because of the work, do so. If there are any that can be fixed relatively quickly because of the knowledge from completing this issue and you have time, feel free to go ahead and fix them.
  • [ ] Check if glossary updates are required for the feature you're documenting - whether an existing term needs to be updated or a new term should be added.
  • [ ] Check if BCD update means that content pages need to have experimental markup removed or deprecated markup added (front matter tags and macros).

hamishwillee avatar Nov 08 '22 03:11 hamishwillee

Yesss! My favorite JS API to be shipped in the near future 😄

Josh-Cena avatar Nov 08 '22 03:11 Josh-Cena

@Josh-Cena Don't get too excited :-). I just updated this to on hold (see "Features to document") above. A little too early, though you might play on nightly if you enable the preference.

hamishwillee avatar Nov 08 '22 03:11 hamishwillee

Don't worry—core-js has got my back. If this is ready for documentation let me know; I'm happy to either write a PR or review one.

Josh-Cena avatar Nov 08 '22 03:11 Josh-Cena

Would be excellent if you could write it and someone else reviews. I'll ping you if I discover this has come alive before you do.

hamishwillee avatar Nov 08 '22 03:11 hamishwillee

This feature has implementations now:

Can we document it yet?

nickserv avatar Feb 18 '23 12:02 nickserv

@nickmccurdy One engine in its browser's prerelease version seems a bit too early. I would rather wait until it becomes stable in Safari or shipped in another browser.

Josh-Cena avatar Feb 18 '23 16:02 Josh-Cena

Well it's already in the public beta channel so I'd expect a stable release soon, and it would be nice for developers to have docs before then

nickserv avatar Feb 18 '23 21:02 nickserv

It's also in FF behind a preference. That was on hold because there wasn't a great feeling that the names were stable. But that was 3 months ago.

hamishwillee avatar Feb 20 '23 01:02 hamishwillee

Safari 16.4. shipped this. I think we can document it now. I added a PR for BCD here: https://github.com/mdn/browser-compat-data/pull/19259

Elchi3 avatar Mar 29 '23 11:03 Elchi3

I'm going to write the page some time this week.

Josh-Cena avatar Mar 29 '23 17:03 Josh-Cena

This is probably worth writing up now. I'm going to send the intent to prototype today, and plan to ship to nightly in the next little while.

mgaudet avatar Mar 29 '23 19:03 mgaudet

PR for reference page is here: https://github.com/mdn/content/pull/25775

Josh-Cena avatar Mar 30 '23 18:03 Josh-Cena

Note, Bugzilla https://bugzilla.mozilla.org/show_bug.cgi?id=1795816 which ships this in nightly was just pushed in/backed out of FF115. That's a good sign this might be imminent in FF.

hamishwillee avatar May 26 '23 00:05 hamishwillee

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/fromAsync

nickserv avatar May 26 '23 06:05 nickserv

According to https://bugzilla.mozilla.org/show_bug.cgi?id=1795816 this is planned for FF nightly release in 115. I've removed the on-hold. It looks like docs work is mostly done. This would mostly be an experimental features and bcd update.

hamishwillee avatar May 28 '23 23:05 hamishwillee

Status:

Existing doc is good - much better than I could have done. So steps are just to:

  • [x] BCD - https://github.com/mdn/browser-compat-data/pull/20082
  • [x] Remove from Experimental - Not needed - was never there.
  • [x] Release note https://github.com/mdn/content/pull/27229
  • [x] Docs - https://github.com/mdn/content/pull/27229
  • [x] dev-docs-complete

hamishwillee avatar Jun 09 '23 04:06 hamishwillee