unknown مقابل any: الخيار الأكثر أماناً

مرحبًا

مشكلة any

let val: any = getData();
val.someMethod(); // TypeScript: OK. Runtime: possible crash

التعريف بـ unknown

let val: unknown = getData();
// val.someMethod(); // Error: Object is of type 'unknown'

تضييق unknown قبل الاستخدام

let input: unknown = getInput();
if (typeof input === 'string') {
  console.log(input.toUpperCase()); // OK — narrowed to string
}

لا يمكن إسناد unknown إلى أنواع محددة

let x: unknown = 'hello';
// let s: string = x; // Error
let s: string = x as string; // OK with assertion

استخدام unknown في كتل catch

try {
  doSomething();
} catch (err: unknown) {
  if (err instanceof Error) {
    console.log(err.message); // safe
  }
}

استخدام unknown للبيانات الخارجية

const raw: unknown = JSON.parse(text);
if (
  typeof raw === 'object' &&
  raw !== null &&
  'name' in raw
) {
  console.log((raw as any).name);
}

حواجز الأنواع مع unknown

function isUser(val: unknown): val is { name: string } {
  return typeof val === 'object' && val !== null && 'name' in val;
}

unknown مقابل never

// unknown: anything can be assigned to it
let a: unknown = 42; // OK

// never: nothing can be assigned to it
function fail(): never { throw new Error(); }

الاختيار بين any وunknown

مكتبات التحقق وقت التشغيل

import { z } from 'zod';
const UserSchema = z.object({ name: z.string(), age: z.number() });
const user = UserSchema.parse(unknownData); // throws if invalid

تحقق سريع

مراجعة