ABI 稳定性中的枚举值

🌐 Enum values in ABI stability

在 Node-API 中定义的所有枚举数据类型都应视为固定大小的 int32_t 值。位标志枚举类型应明确记录，并且它们可以像位值一样与位运算符（如按位或 |）一起使用。除非另有说明，否则枚举类型应视为可扩展的。

🌐 All enum data types defined in Node-API should be considered as a fixed size int32_t value. Bit flag enum types should be explicitly documented, and they work with bit operators like bit-OR (|) as a bit value. Unless otherwise documented, an enum type should be considered to be extensible.

一个新的枚举值将被添加到枚举定义的末尾。枚举值不会被删除或重命名。

🌐 A new enum value will be added at the end of the enum definition. An enum value will not be removed or renamed.

对于从 Node-API 函数返回的枚举类型，或作为 Node-API 函数的输出参数提供的枚举类型，其值为整数值，插件应处理未知值。可以在不使用版本保护的情况下引入新值。例如，在 switch 语句中检查 napi_status 时，插件应包含默认分支，因为在较新的 Node.js 版本中可能会引入新的状态码。

🌐 For an enum type returned from a Node-API function, or provided as an out parameter of a Node-API function, the value is an integer value and an addon should handle unknown values. New values are allowed to be introduced without a version guard. For example, when checking napi_status in switch statements, an addon should include a default branch, as new status codes may be introduced in newer Node.js versions.

对于在输入参数中使用的枚举类型，将未知整数值传递给 Node-API 函数的结果是未定义的，除非另有文档说明。新增的值会附带版本保护，以指示它被引入的 Node-API 版本。例如，napi_get_all_property_names 可以通过新增 napi_key_filter 枚举值来扩展。

🌐 For an enum type used in an in-parameter, the result of passing an unknown integer value to Node-API functions is undefined unless otherwise documented. A new value is added with a version guard to indicate the Node-API version in which it was introduced. For example, napi_get_all_property_names can be extended with new enum value of napi_key_filter.

对于同时用于输入参数和输出参数的枚举类型，允许在不使用版本保护的情况下引入新值。

🌐 For an enum type used in both in-parameters and out-parameters, new values are allowed to be introduced without a version guard.