feat: add isNull util function (#16)

Author: klmhyeonwoo

README.md

@@ -51,6 +51,8 @@ const isHttpUrl = validationUtil.checkHttpUrl("https://example.com"); // true
 // Common utilities
 const empty = commonUtil.isEmpty(""); // true
 const notEmpty = commonUtil.isEmpty("hello"); // false
+const nullCheck = commonUtil.isNull(null); // true
+const notNull = commonUtil.isNull("hello"); // false
 
 // Cookie utilities
 cookieUtil.setCookie("theme", "dark");
@@ -82,6 +84,7 @@ const theme = cookieUtil.getCookie("theme");
 ### CommonUtil
 
 - `isEmpty(value: unknown): boolean` - Checks if a value is empty (null, undefined, "", 0, [], {}, empty Set/Map, NaN, or invalid Date)
+- `isNull(value: unknown): value is null` - Type guard that checks if a value is null and narrows the type
 
 ### CookieUtil
 

package/commonUtil/index.ts

@@ -1 +1,2 @@
 export { default as isEmpty } from "./isEmpty";
+export { default as isNull } from "./isNull";

package/commonUtil/isNull/index.test.ts

@@ -0,0 +1,20 @@
+import { describe, expect, test } from "vitest";
+import isNull from ".";
+
+describe("isNull 유틸 함수 테스트", () => {
+  test("null이 들어오는 경우 true를 반환한다.", () => {
+    expect(isNull(null)).toBe(true);
+  });
+  test("undefined이 들어오는 경우 false를 반환한다.", () => {
+    expect(isNull(undefined)).toBe(false);
+  });
+  test("빈 문자열이 들어오는 경우 false를 반환한다.", () => {
+    expect(isNull("")).toBe(false);
+  });
+  test("공백 문자열이 들어오는 경우 false를 반환한다.", () => {
+    expect(isNull(" ")).toBe(false);
+  });
+  test("0이 들어오는 경우 false를 반환한다.", () => {
+    expect(isNull(0)).toBe(false);
+  });
+});

package/commonUtil/isNull/index.ts

@@ -0,0 +1,3 @@
+export default function isNull(value: unknown): value is null {
+  return value === null;
+}