ts-enum-next 1.0.7 → 1.0.8

package/dist/index.d.ts

@@ -15,8 +15,8 @@ declare abstract class Enum<T extends string | number = string | number> {
      */
     description?: unknown | undefined);
     static values<T extends Enum>(this: new (...args: any[]) => T): T[];
-    static fromValue<T extends Enum>(this: new (...args: any[]) => T, value: T['value']): T;
-    static fromName<T extends Enum>(this: new (...args: any[]) => T, name: string): T;
+    static fromValue<T extends Enum>(this: new (...args: any[]) => T, value: T['value']): T | undefined;
+    static fromName<T extends Enum>(this: new (...args: any[]) => T, name: string): T | undefined;
     static setOf<T extends Enum>(this: new (...args: any[]) => T, ...items: T[]): Set<T>;
     static enumMap<V, T extends Enum = Enum>(this: new (...args: any[]) => T, map: Record<string | number, V>): Map<T, V>;
     toString(): string;

package/dist/index.js

@@ -25,19 +25,21 @@ class Enum {
     }
     // 通过值获取枚举实例
     static fromValue(value) {
-        const enumInstance = Enum._valueMap.get(this)?.get(value);
-        if (!enumInstance) {
-            throw new Error(`No enum value ${value} found`);
-        }
-        return enumInstance;
+        if (value === undefined || value === null)
+            return undefined;
+        const valueMap = Enum._valueMap.get(this);
+        if (!valueMap)
+            return undefined;
+        return valueMap.get(value);
     }
     // 通过名称获取枚举实例
     static fromName(name) {
-        const enumInstance = Enum._nameMap.get(this)?.get(name);
-        if (!enumInstance) {
-            throw new Error(`No enum name ${name} found`);
-        }
-        return enumInstance;
+        if (name === undefined || name === null || name === '')
+            return undefined;
+        const nameMap = Enum._nameMap.get(this);
+        if (!nameMap)
+            return undefined;
+        return nameMap.get(name);
     }
     // 创建枚举集合
     static setOf(...items) {

package/dist/index.test.js

@@ -88,11 +88,15 @@ describe('Enum', () => {
             expect(HttpStatus.fromValue(404)).toBe(HttpStatus.NOT_FOUND);
             expect(HttpStatus.fromValue(500)).toBe(HttpStatus.SERVER_ERROR);
         });
-        it('should throw error for non-existent numeric value', () => {
-            expect(() => HttpStatus.fromValue(999)).toThrow('No enum value 999 found');
+        it('should return undefined for non-existent numeric value', () => {
+            expect(HttpStatus.fromValue(999)).toBeUndefined();
         });
-        it('should throw error for non-existent string value', () => {
-            expect(() => OrderStatus.fromValue('INVALID')).toThrow('No enum value INVALID found');
+        it('should return undefined for non-existent string value', () => {
+            expect(OrderStatus.fromValue('INVALID')).toBeUndefined();
+        });
+        it('should return undefined when value is null or undefined', () => {
+            expect(HttpStatus.fromValue(undefined)).toBeUndefined();
+            expect(HttpStatus.fromValue(null)).toBeUndefined();
         });
     });
     describe('fromName()', () => {
@@ -111,11 +115,16 @@ describe('Enum', () => {
             expect(HttpStatus.fromName('NOT_FOUND')).toBe(HttpStatus.NOT_FOUND);
             expect(HttpStatus.fromName('SERVER_ERROR')).toBe(HttpStatus.SERVER_ERROR);
         });
-        it('should throw error for non-existent name', () => {
-            expect(() => HttpStatus.fromName('INVALID')).toThrow('No enum name INVALID found');
+        it('should return undefined for non-existent name', () => {
+            expect(HttpStatus.fromName('INVALID')).toBeUndefined();
         });
         it('should be case-sensitive', () => {
-            expect(() => HttpStatus.fromName('ok')).toThrow('No enum name ok found');
+            expect(HttpStatus.fromName('ok')).toBeUndefined();
+        });
+        it('should return undefined when name is null, undefined or empty string', () => {
+            expect(HttpStatus.fromName(undefined)).toBeUndefined();
+            expect(HttpStatus.fromName(null)).toBeUndefined();
+            expect(HttpStatus.fromName('')).toBeUndefined();
         });
     });
     describe('setOf()', () => {
@@ -240,12 +249,12 @@ describe('Enum', () => {
         });
         it('should not interfere with each other when querying by value', () => {
             // 虽然值相同，但是不同的枚举类
-            expect(() => HttpStatus.fromValue('PENDING')).toThrow();
-            expect(() => OrderStatus.fromValue(200)).toThrow();
+            expect(HttpStatus.fromValue('PENDING')).toBeUndefined();
+            expect(OrderStatus.fromValue(200)).toBeUndefined();
         });
         it('should not interfere with each other when querying by name', () => {
-            expect(() => HttpStatus.fromName('Pending')).toThrow();
-            expect(() => OrderStatus.fromName('OK')).toThrow();
+            expect(HttpStatus.fromName('Pending')).toBeUndefined();
+            expect(OrderStatus.fromName('OK')).toBeUndefined();
         });
     });
     describe('Edge cases', () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-enum-next",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Ultimate Enum Enhancement for TypeScript",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",