util: add types.isFloat16Array()

PR-URL: #57879
Reviewed-By: Jordan Harband <ljharb@gmail.com>
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>

Author: LiviaMedeiros

doc/api/util.md

@@ -3102,6 +3102,23 @@ types.isExternal(new String('foo')); // returns false
 For further information on `napi_create_external`, refer to
 [`napi_create_external()`][].
 
+### `util.types.isFloat16Array(value)`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+* `value` {any}
+* Returns: {boolean}
+
+Returns `true` if the value is a built-in {Float16Array} instance.
+
+```js
+util.types.isFloat16Array(newArrayBuffer()); // Returns false
+util.types.isFloat16Array(newFloat16Array()); // Returns true
+util.types.isFloat16Array(newFloat32Array()); // Returns false
+```
+
 ### `util.types.isFloat32Array(value)`
 
 <!-- YAML

lib/internal/util/types.js

@@ -38,6 +38,10 @@ function isInt32Array(value) {
 returnTypedArrayPrototypeGetSymbolToStringTag(value)==='Int32Array';
 }
 
+functionisFloat16Array(value){
+returnTypedArrayPrototypeGetSymbolToStringTag(value)==='Float16Array';
+}
+
 functionisFloat32Array(value){
 returnTypedArrayPrototypeGetSymbolToStringTag(value)==='Float32Array';
 }
@@ -65,6 +69,7 @@ module.exports = {
  isInt8Array,
  isInt16Array,
  isInt32Array,
+ isFloat16Array,
  isFloat32Array,
  isFloat64Array,
  isBigInt64Array,

test/parallel/test-util-types.js

@@ -1,4 +1,5 @@
-// Flags: --experimental-vm-modules --expose-internals --allow-natives-syntax
+// Flags: --experimental-vm-modules --expose-internals --allow-natives-syntax --js-float16array
+// TODO(LiviaMedeiros): once `Float16Array` is unflagged in v8, remove `--js-float16array` above
 'use strict';
 constcommon=require('../common');
 constassert=require('assert');
@@ -9,6 +10,9 @@ const { JSStream } = internalBinding('js_stream');
 
 constexternal=(newJSStream())._externalStream;
 
+// TODO(LiviaMedeiros): once linter recognizes `Float16Array`, remove next line
+const{ Float16Array }=globalThis;
+
 for(const[value,_method]of[
 [external,'isExternal'],
 [newDate()],
@@ -38,6 +42,7 @@ for (const [ value, _method ] of [
 [newInt8Array()],
 [newInt16Array()],
 [newInt32Array()],
+[newFloat16Array()],
 [newFloat32Array()],
 [newFloat64Array()],
 [newBigInt64Array()],
@@ -102,6 +107,9 @@ for (const [ value, _method ] of [
 assert(!types.isInt32Array({[Symbol.toStringTag]: 'Int32Array'}));
 assert(types.isInt32Array(vm.runInNewContext('new Int32Array')));
 
+assert(!types.isFloat16Array({[Symbol.toStringTag]: 'Float16Array'}));
+assert(types.isFloat16Array(vm.runInNewContext('new Float16Array')));
+
 assert(!types.isFloat32Array({[Symbol.toStringTag]: 'Float32Array'}));
 assert(types.isFloat32Array(vm.runInNewContext('new Float32Array')));
 
@@ -127,6 +135,7 @@ for (const [ value, _method ] of [
 constint8Array=newInt8Array(arrayBuffer);
 constint16Array=newInt16Array(arrayBuffer);
 constint32Array=newInt32Array(arrayBuffer);
+constfloat16Array=newFloat16Array(arrayBuffer);
 constfloat32Array=newFloat32Array(arrayBuffer);
 constfloat64Array=newFloat64Array(arrayBuffer);
 constbigInt64Array=newBigInt64Array(arrayBuffer);
@@ -141,6 +150,7 @@ for (const [ value, _method ] of [
 constfakeInt8Array={__proto__: Int8Array.prototype};
 constfakeInt16Array={__proto__: Int16Array.prototype};
 constfakeInt32Array={__proto__: Int32Array.prototype};
+constfakeFloat16Array={__proto__: Float16Array.prototype};
 constfakeFloat32Array={__proto__: Float32Array.prototype};
 constfakeFloat64Array={__proto__: Float64Array.prototype};
 constfakeBigInt64Array={__proto__: BigInt64Array.prototype};
@@ -164,6 +174,10 @@ for (const [ value, _method ] of [
 Object.setPrototypeOf(newInt16Array(arrayBuffer),Int16Array.prototype);
 conststealthyInt32Array=
 Object.setPrototypeOf(newInt32Array(arrayBuffer),Int32Array.prototype);
+conststealthyFloat16Array=
+Object.setPrototypeOf(
+newFloat16Array(arrayBuffer),Float16Array.prototype
+);
 conststealthyFloat32Array=
 Object.setPrototypeOf(
 newFloat32Array(arrayBuffer),Float32Array.prototype
@@ -191,6 +205,7 @@ for (const [ value, _method ] of [
 int8Array,fakeInt8Array,stealthyInt8Array,
 int16Array,fakeInt16Array,stealthyInt16Array,
 int32Array,fakeInt32Array,stealthyInt32Array,
+float16Array,fakeFloat16Array,stealthyFloat16Array,
 float32Array,fakeFloat32Array,stealthyFloat32Array,
 float64Array,fakeFloat64Array,stealthyFloat64Array,
 bigInt64Array,fakeBigInt64Array,stealthyBigInt64Array,
@@ -208,6 +223,7 @@ for (const [ value, _method ] of [
 int8Array,stealthyInt8Array,
 int16Array,stealthyInt16Array,
 int32Array,stealthyInt32Array,
+float16Array,stealthyFloat16Array,
 float32Array,stealthyFloat32Array,
 float64Array,stealthyFloat64Array,
 bigInt64Array,stealthyBigInt64Array,
@@ -222,6 +238,7 @@ for (const [ value, _method ] of [
 int8Array,stealthyInt8Array,
 int16Array,stealthyInt16Array,
 int32Array,stealthyInt32Array,
+float16Array,stealthyFloat16Array,
 float32Array,stealthyFloat32Array,
 float64Array,stealthyFloat64Array,
 bigInt64Array,stealthyBigInt64Array,
@@ -248,6 +265,9 @@ for (const [ value, _method ] of [
 isInt32Array: [
 int32Array,stealthyInt32Array,
 ],
+isFloat16Array: [
+float16Array,stealthyFloat16Array,
+],
 isFloat32Array: [
 float32Array,stealthyFloat32Array,
 ],

tools/doc/type-parser.mjs

@@ -19,7 +19,7 @@ const jsGlobalTypes = [
 'TypeError','URIError','WeakMap','WeakSet',
 
 'TypedArray',
-'Float32Array','Float64Array',
+'Float16Array','Float32Array','Float64Array',
 'Int8Array','Int16Array','Int32Array',
 'Uint8Array','Uint8ClampedArray','Uint16Array','Uint32Array',
 ];