Object.prototype.__defineSetter__()

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Hinweis: Diese Funktion ist zugunsten der Definition von setters mittels der Object-Initialisierer-Syntax oder der Object.defineProperty() API veraltet. Das Verhalten dieser Methode ist nur zum Zweck der Web-Kompatibilität spezifiziert und muss auf keiner Plattform implementiert werden. Sie funktioniert möglicherweise nicht überall.

Die __defineSetter__()-Methode von Object-Instanzen bindet eine Eigenschaft eines Objekts an eine Funktion, die aufgerufen wird, wenn versucht wird, diese Eigenschaft zu setzen.

Syntax

js
__defineSetter__(prop, func)

Parameter

prop

Ein String, der den Namen der Eigenschaft enthält, an die der Setter func gebunden ist.

func

Eine Funktion, die aufgerufen wird, wenn versucht wird, die angegebene Eigenschaft zu setzen. Diese Funktion erhält den folgenden Parameter:

val

Der Wert, der versucht wird, prop zuzuweisen.

Rückgabewert

Keiner (undefined).

Ausnahmen

TypeError

Wird ausgelöst, wenn func keine Funktion ist.

Beschreibung

Alle Objekte, die von Object.prototype erben (das heißt alle außer null-Prototype-Objekten), erben die __defineSetter__()-Methode. Diese Methode ermöglicht es, einen Setter auf einem bereits vorhandenen Objekt zu definieren. Dies entspricht Object.defineProperty(obj, prop, { set: func, configurable: true, enumerable: true }), was bedeutet, dass die Eigenschaft aufzählbar und konfigurierbar ist und jeder vorhandene Getter, falls vorhanden, erhalten bleibt.

__defineSetter__() wird in der Spezifikation als "normativ optional" definiert, was bedeutet, dass keine Implementierung verpflichtet ist, dies zu unterstützen. Allerdings implementieren alle großen Browser diese Funktion, und aufgrund ihrer fortgesetzten Verwendung ist es unwahrscheinlich, dass sie entfernt wird. Wenn ein Browser __defineSetter__() implementiert, muss er auch die Methoden __lookupGetter__(), __lookupSetter__() und __defineGetter__() implementieren.

Beispiele

Verwendung von __defineSetter__()

js
const o = {};
o.__defineSetter__("value", function (val) {
  this.anotherValue = val;
});
o.value = 5;
console.log(o.value); // undefined
console.log(o.anotherValue); // 5

Definieren einer Setter-Eigenschaft auf standardmäßige Weise

Sie können die set-Syntax verwenden, um einen Setter zu definieren, wenn das Objekt zuerst initialisiert wird.

js
const o = {
  set value(val) {
    this.anotherValue = val;
  },
};
o.value = 5;
console.log(o.value); // undefined
console.log(o.anotherValue); // 5

Sie können auch Object.defineProperty() verwenden, um einen Setter auf einem Objekt zu definieren, nachdem es erstellt wurde. Im Vergleich zu __defineSetter__() ermöglicht diese Methode, die Aufzählbarkeit und Konfigurierbarkeit des Setters zu steuern, sowie Symbol-Eigenschaften zu definieren. Die Object.defineProperty()-Methode funktioniert auch mit null-Prototype-Objekten, die nicht von Object.prototype erben und daher nicht über die __defineSetter__()-Methode verfügen.

js
const o = {};
Object.defineProperty(o, "value", {
  set(val) {
    this.anotherValue = val;
  },
  configurable: true,
  enumerable: true,
});
o.value = 5;
console.log(o.value); // undefined
console.log(o.anotherValue); // 5

Spezifikationen

Specification
ECMAScript Language Specification
# sec-object.prototype.__defineSetter__

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch