handler.getOwnPropertyDescriptor()

Die folgenden Parameter werden an die Methode getOwnPropertyDescriptor() übergeben. this ist an den Handler gebunden.

target

Das Zielobjekt.

property

Ein String oder Symbol, der den Eigenschaftsnamen darstellt.

Die Methode getOwnPropertyDescriptor() muss ein Objekt oder undefined zurückgeben, das den Eigenschaftsbeschreiber darstellt. Fehlende Attribute werden auf die gleiche Weise normalisiert wie bei Object.defineProperty().

Diese Trap kann folgende Operationen abfangen:

• Object.getOwnPropertyDescriptor()
• Reflect.getOwnPropertyDescriptor()

Oder jede andere Operation, die die [[GetOwnProperty]] interne Methode aufruft.

Die [[GetOwnProperty]]-interne Methode des Proxys wirft einen TypeError, wenn die Handler-Definition eine der folgenden Invarianten verletzt:

• Das Ergebnis muss entweder ein Object oder undefined sein.
• Eine Eigenschaft kann nicht als nicht existent gemeldet werden, wenn sie als nicht konfigurierbare Eigenschaft des Zielobjekts existiert. Das heißt, wenn Reflect.getOwnPropertyDescriptor() configurable: false für die Eigenschaft auf target zurückgibt, darf die Trap nicht undefined zurückgeben.
• Eine Eigenschaft kann nicht als nicht existent gemeldet werden, wenn sie als eigene Eigenschaft eines nicht erweiterbaren Zielobjekts existiert. Das heißt, wenn Reflect.isExtensible() false für das Zielobjekt zurückgibt, darf die Trap nicht undefined zurückgeben.
• Eine Eigenschaft kann nicht als existent gemeldet werden, wenn sie nicht als eigene Eigenschaft des Zielobjekts existiert und das Zielobjekt nicht erweiterbar ist. Das heißt, wenn Reflect.isExtensible() false für das Zielobjekt zurückgibt und Reflect.getOwnPropertyDescriptor() undefined für die Eigenschaft auf target zurückgibt, muss die Trap undefined zurückgeben.
• Eine Eigenschaft kann nicht als nicht konfigurierbar gemeldet werden, es sei denn, sie existiert als nicht konfigurierbare Eigenschaft des Zielobjekts. Das heißt, wenn Reflect.getOwnPropertyDescriptor() undefined oder configurable: true für die Eigenschaft auf target zurückgibt, darf die Trap nicht configurable: false zurückgeben.
• Eine Eigenschaft kann nicht sowohl als nicht konfigurierbar als auch als nicht beschreibbar gemeldet werden, es sei denn, sie existiert als nicht konfigurierbare, nicht beschreibbare Eigenschaft des Zielobjekts. Das heißt zusätzlich zur vorherigen Invariante, wenn Reflect.getOwnPropertyDescriptor() configurable: false, writable: true für die Eigenschaft auf target zurückgibt, darf die Trap nicht configurable: false, writable: false zurückgeben.
• Wenn eine Eigenschaft eine entsprechende Eigenschaft auf dem Zielobjekt hat, dann muss der Eigenschaftsbeschreiber der Zielobjekteigenschaft mit descriptor kompatibel sein. Das heißt, wenn man target als normales Objekt betrachtet, dann darf Object.defineProperty(target, property, resultObject) keinen Fehler werfen. Der Verweis auf Object.defineProperty() enthält mehr Informationen, aber zusammengefasst, wenn die Zielobjekteigenschaft nicht konfigurierbar ist, muss Folgendes zutreffen:
  • configurable, enumerable, get und set müssen die gleichen wie die Originale sein. writable muss ebenfalls original sein aufgrund der vorherigen Invariante.
  • Die Eigenschaft muss als Daten- oder Zugriffseigenschaft bleiben
  • Das value-Attribut kann nur geändert werden, wenn writable true ist

Der folgende Code fängt Object.getOwnPropertyDescriptor() ab.

const p = new Proxy(
  { a: 20 },
  {
    getOwnPropertyDescriptor(target, prop) {
      console.log(`called: ${prop}`);
      return { configurable: true, enumerable: true, value: 10 };
    },
  },
);

console.log(Object.getOwnPropertyDescriptor(p, "a").value);
// "called: a"
// 10

Der folgende Code verletzt eine Invariante.

const obj = { a: 10 };
Object.preventExtensions(obj);
const p = new Proxy(obj, {
  getOwnPropertyDescriptor(target, prop) {
    return undefined;
  },
});

Object.getOwnPropertyDescriptor(p, "a"); // TypeError is thrown

• Proxy
• Proxy() Konstruktor
• Object.getOwnPropertyDescriptor()
• Reflect.getOwnPropertyDescriptor()