mirror of
https://github.com/facebook/react-native.git
synced 2026-11-18 20:19:07 +00:00
Align Flow lib defs for Node.js util with v24 (#55016)
Summary: Pull Request resolved: https://github.com/facebook/react-native/pull/55016 This is an AI-assisted change to align the Flow definitions for the `util` module with the Node.js docs as at v24. **New v20-v24 APIs:** 1. **`parseEnv(content)`** - Environment file (.env) parser (added in v20.12.0) - Parses `.env` file content into key-value object - Last value wins for duplicate keys - https://nodejs.org/api/util.html#utilparseenvcontent 2. **`diff(actual, expected)`** - String/array comparison (added in v22.15.0) 🧪 - Uses Myers diff algorithm for comparison - Returns array of tuples: `[operation: -1 | 0 | 1, value: string]` - `-1` = expected only (deletion) - `0` = both (unchanged) - `1` = actual only (insertion) - Experimental API - https://nodejs.org/api/util.html#utildiffactual-expected 3. **`getSystemErrorMessage(err)`** - Error code to message (added in v22.12.0) - Returns the error message string for a numeric error code - https://nodejs.org/api/util.html#utilgetsystemerrormessageerr 4. **`getCallSites([frameCount | options])`** - Call stack capture (added in v22.9.0) - Captures call stack as `CallSiteObject` instances with: - `functionName`, `scriptName`, `scriptId`, `lineNumber`, `columnNumber` - `scriptId` property added in v22.14.0 - https://nodejs.org/api/util.html#utilgetcallsitesframecount 5. **`types.isFloat16Array()`** - Type check for Float16Array (added in v24.0.0) - Checks if value is a Float16Array instance - https://nodejs.org/api/util.html#utiltypesisfloat16arrayvalue **New Classes (v19):** 6. **`MIMEType` class** - MIME type parsing and manipulation (added in v19.1.0, v18.13.0) - Properties: `type`, `subtype`, `essence`, `params` - Methods: `toString()` - Implements MIMEType proposal spec - https://nodejs.org/api/util.html#class-utilmimetype 7. **`MIMEParams` class** - MIME parameters handler (added in v19.1.0, v18.13.0) - Methods: `delete()`, `get()`, `has()`, `set()`, `entries()`, `keys()`, `values()` - https://nodejs.org/api/util.html#class-utilmimeparams **Updated APIs:** 8. **`parseArgs()` - Added `allowNegative` option** (added in v22.4.0) - Allows explicitly setting boolean options to false with `--no-` prefix - Example: `--no-verbose` sets `verbose: false` - https://nodejs.org/api/util.html#utilparseargsconfig **Type Safety Improvements:** 9. **Exact-by-default syntax** - Simplified object types - Changed `{|...|}` `{}` in parseArgs types (Flow configured with exact-by-default) - Changed default generic types from `{||}` → `{}` 10. **styleText()** already present with full type definitions - 18 foreground colors, 18 background colors, 12 modifiers - https://nodejs.org/api/util.html#utilstyletextformat-text **References:** - Node.js util module docs: https://nodejs.org/api/util.html - MIMEType proposal: https://bmeck.github.io/node-proposal-mime-api/ Changelog: [Internal] --- > Generated by [Confucius Code Assist (CCA)](https://www.internalfb.com/wiki/Confucius/Analect/Shared_Analects/Confucius_Code_Assist_(CCA)/) [Confucius Session](https://www.internalfb.com/confucius?host=devvm45708.cln0.facebook.com&port=8086&tab=Chat&session_id=1a3aa26e-e5a9-11f0-8d47-71a4a90f0494&entry_name=Code+Assist), [Trace](https://www.internalfb.com/confucius?session_id=1a3aa26e-e5a9-11f0-8d47-71a4a90f0494&tab=Trace) Reviewed By: vzaidman Differential Revision: D89942136 fbshipit-source-id: c26d6c6a8003a30b50443020b06228ce2a012838
This commit is contained in:
1 parent
e73ab78672
commit
f5c1126074
1 file changed
+51
-8
Vendored
+51
-8
@@ -3683,31 +3683,33 @@ declare module 'util' {
|
||||
declare function stripVTControlCharacters(str: string): string;
|
||||
|
||||
declare function parseArgs<
|
||||
TOptions: {+[string]: util$ParseArgsOption} = {||},
|
||||
>(config: {|
|
||||
TOptions: {+[string]: util$ParseArgsOption} = {},
|
||||
>(config: {
|
||||
args?: Array<string>,
|
||||
options?: TOptions,
|
||||
strict?: boolean,
|
||||
allowPositionals?: boolean,
|
||||
allowNegative?: boolean,
|
||||
tokens?: false,
|
||||
|}): {|
|
||||
}): {
|
||||
values: util$ParseArgsOptionsToValues<TOptions>,
|
||||
positionals: Array<string>,
|
||||
|};
|
||||
};
|
||||
|
||||
declare function parseArgs<
|
||||
TOptions: {[string]: util$ParseArgsOption} = {||},
|
||||
>(config: {|
|
||||
TOptions: {[string]: util$ParseArgsOption} = {},
|
||||
>(config: {
|
||||
args?: Array<string>,
|
||||
options?: TOptions,
|
||||
strict?: boolean,
|
||||
allowPositionals?: boolean,
|
||||
allowNegative?: boolean,
|
||||
tokens: true,
|
||||
|}): {|
|
||||
}): {
|
||||
values: util$ParseArgsOptionsToValues<TOptions>,
|
||||
positionals: Array<string>,
|
||||
tokens: Array<util$ParseArgsToken>,
|
||||
|};
|
||||
};
|
||||
|
||||
declare class TextDecoder {
|
||||
constructor(
|
||||
@@ -3733,6 +3735,46 @@ declare module 'util' {
|
||||
encoding: string;
|
||||
}
|
||||
|
||||
declare class MIMEType {
|
||||
constructor(input: string): void;
|
||||
type: string;
|
||||
subtype: string;
|
||||
+essence: string;
|
||||
+params: MIMEParams;
|
||||
toString(): string;
|
||||
}
|
||||
|
||||
declare class MIMEParams {
|
||||
delete(name: string): void;
|
||||
get(name: string): ?string;
|
||||
has(name: string): boolean;
|
||||
set(name: string, value: string): void;
|
||||
entries(): Iterator<[string, string]>;
|
||||
keys(): Iterator<string>;
|
||||
values(): Iterator<string>;
|
||||
}
|
||||
|
||||
declare function parseEnv(content: string): {[key: string]: string, ...};
|
||||
|
||||
declare type util$DiffEntry = [operation: -1 | 0 | 1, value: string];
|
||||
declare function diff(
|
||||
actual: string | $ReadOnlyArray<string>,
|
||||
expected: string | $ReadOnlyArray<string>,
|
||||
): Array<util$DiffEntry>;
|
||||
|
||||
declare function getSystemErrorMessage(err: number): string;
|
||||
|
||||
declare type util$CallSiteObject = {
|
||||
functionName: string,
|
||||
scriptName: string,
|
||||
scriptId: string,
|
||||
lineNumber: number,
|
||||
columnNumber: number,
|
||||
};
|
||||
declare function getCallSites(
|
||||
frameCountOrOptions?: number | Readonly<{frameCount?: number}>,
|
||||
): Array<util$CallSiteObject>;
|
||||
|
||||
declare var types: {
|
||||
isAnyArrayBuffer: (value: unknown) => boolean,
|
||||
isArgumentsObject: (value: unknown) => boolean,
|
||||
@@ -3745,6 +3787,7 @@ declare module 'util' {
|
||||
isDataView: (value: unknown) => boolean,
|
||||
isDate: (value: unknown) => boolean,
|
||||
isExternal: (value: unknown) => boolean,
|
||||
isFloat16Array: (value: unknown) => boolean,
|
||||
isFloat32Array: (value: unknown) => boolean,
|
||||
isFloat64Array: (value: unknown) => boolean,
|
||||
isGeneratorFunction: (value: unknown) => boolean,
|
||||
|
||||
Reference in new issue
Block a user