instanceof का Guard

Basic instanceof Checks

value instanceof ClassName उपयोग करें यह determine करने के लिए कि क्या एक object runtime पर एक specific class का instance है, और TypeScript उस branch के अंदर value का type narrow करता है जहां check succeed होता है।

यह काम करता है क्योंकि instanceof एक असली JavaScript runtime check है जो prototype chain पर based है, कोई ऐसी चीज़ नहीं जो TypeScript सिर्फ typing के लिए invent करता हो।

उदाहरण: Basic instanceof Checks

class Car { drive() { console.log("Driving"); } }
class Bike { pedal() { console.log("Pedaling"); } }
function move(vehicle: Car | Bike) {
  if (vehicle instanceof Car) {
    vehicle.drive();
  } else {
    vehicle.pedal();
  }
}
move(new Car());

Date के साथ instanceof

Date जैसी built-in classes को भी instanceof से check किया जा सकता है, जो उपयोगी है जब एक value का origin ambiguous हो, जैसे एक third-party library से आने वाला data जो वापस या तो एक Date object या एक plain string दे सकता हो।

उदाहरण: instanceof with Date

function printDate(value: string | Date) {
  if (value instanceof Date) {
    console.log(value.getFullYear());
  } else {
    console.log(value);
  }
}
printDate(new Date(2024, 0, 1));

Error के साथ instanceof

Error objects को आमतौर पर एक catch block में caught values handle करते समय instanceof से check किया जाता है, क्योंकि catch clauses अपने parameter को unknown type करती हैं और instanceof आपको .message पढ़ने से पहले इसे safely Error (या एक custom subclass) तक narrow करने देता है।

उदाहरण: instanceof with Error

try {
  throw new Error("Something failed");
} catch (e) {
  if (e instanceof Error) {
    console.log(e.message);
  }
}

Custom Classes के साथ instanceof

Custom classes को अक्सर discriminators के रूप में उपयोग किया जाता है जब objects के पास data के साथ behavior भी हो, instanceof को class instances के बीच उसी तरह फर्क करने देते हुए जैसे यह built-ins के बीच करता है, जो खासकर एक OOP-style codebase में कई related classes के साथ काम करते समय handy है।

उदाहरण: instanceof with Custom Classes

class Admin { manage() { console.log("Managing"); } }
class Guest { browse() { console.log("Browsing"); } }
function handle(user: Admin | Guest) {
  if (user instanceof Admin) {
    user.manage();
  } else {
    user.browse();
  }
}
handle(new Guest());

Multiple Classes के साथ instanceof

जब एक union में कई class types हों, multiple instanceof checks value को step by step narrow कर सकते हैं, if/else if branches की एक chain जैसा, जब तक कोड में हर point पर सिर्फ एक possible class न बचे।

उदाहरण: instanceof with Multiple Classes

class Circle {}
class Square {}
class Triangle {}
function name(shape: Circle | Square | Triangle): string {
  if (shape instanceof Circle) return "Circle";
  if (shape instanceof Square) return "Square";
  return "Triangle";
}
console.log(name(new Square()));