891779 - Needs to document Array find and findIndex

Status: RESOLVED FIXED

(Developer Documentation Graveyard :: JavaScript, defect, P5)

Description

[Jeremie Patonnier :Jeremie]

:: Developer Documentation Request

      Request Type: New Documentation
     Gecko Version: 25 Branch
 Technical Contact: 

:: Details

The ES6 find and findIndex property for Array are now implemented in Gecko:

* Array.prototype.find(predicate, thisArg = undefined)
  Returns the value or undefined if not found.

* Array.prototype.findIndex(predicate, thisArg = undefined)
  Returns the index or -1 if not found.

See ES6 spec sections 15.4.3.23 and 15.4.3.24.
See also https://github.com/rwldrn/tc39-notes/blob/master/es6/2013-03/mar-14.md#410-array-extras

Comment 1

[David Bruant]

A website broke when that was introduced (bug 890070). TC39 is aware [1].
If too much breaks, the methods may need to be renamed.
Well... that doesn't change the need for documentation... quite the opposite.

Alright, let's do this!!!


[1] https://mail.mozilla.org/pipermail/es-discuss/2013-July/031643.html

Comment 2

[Florian Scholz (Open Web Docs)]

Mentioned on Fx25 for developers
https://developer.mozilla.org/en-US/Firefox/Releases/25#JavaScript

Listed on
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array#Iteration_methods
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/prototype#Iteration_methods

New pages:
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/find
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/findIndex

As always: Reviews, comments or additional examples are more than welcome on the MDN wiki pages.