Allow type narrowing for arrays using Array#forEach and assertion function

lib Update Request

Configuration Check

My compilation target is ES5 and my lib is the default.

Missing / Incorrect Definition

Array type narrowing using Array#forEach with assertion function, in a fashion similar to Array#every, has not been defined. Also applies to ReadonlyArray.

Sample Code

const foo: (number | string)[] = ['aaa'];

function assertString(x: unknown): asserts x is string {
  if (typeof x !== 'string') throw new Error('Must be a string!');
}

foo.forEach(assertString);
foo[0].slice(0); // foo should be string[] from here

Documentation Link

Based on Array#every<S extends T> from lib.es5.d.ts.

A pull request for implementing this definition has been created #52388.

Comienza en lib/lib.es5.d.ts, usando la definición existente de Array#every como referencia. Comprueba las declaraciones de forEach de Array y ReadonlyArray con el ejemplo de función de aserción proporcionado. Se considera terminado cuando el ejemplo estrecha el tipo de elemento del array después de forEach sin errores y cubre tanto los arrays mutables como los de solo lectura.