JavaScript-Konstruktor-Seitenvorlage
Hinweis: Entfernen Sie diese gesamte erklärende Anmerkung vor der Veröffentlichung
Frontmatter der Seite:
Das Frontmatter am Anfang der Seite wird verwendet, um „Seitenmetadaten“ zu definieren. Die Werte sollten für den jeweiligen Konstruktor entsprechend aktualisiert werden.
---
title: Constructor() constructor
short-title: Constructor()
slug: Web/JavaScript/Reference/Global_Objects/Constructor/Constructor
page-type: javascript-constructor
status:
- deprecated
- experimental
- non-standard
browser-compat: javascript.builtins.Constructor.Constructor
sidebar: jsref
---
- title
-
Überschrift, die oben auf der Seite angezeigt wird. Formatieren Sie sie als
Constructor() constructor. Beispielsweise hat der KonstruktorArray()den titleArray() constructor. - short-title
-
Ein kurzer Titel, der in Breadcrumbs und Sidebars verwendet wird. Formatieren Sie ihn als
Constructor(). Beispielsweise hat der KonstruktorArray()den short-titleArray(). - slug
-
Das Ende des URL-Pfads nach
https://developer.mozilla.org/de/docs/. Dies sollte wieWeb/JavaScript/Reference/Global_Objects/Constructor/Constructorformatiert sein. - page-type
-
Der Schlüssel
page-typefür JavaScript-Konstruktoren istjavascript-constructor. - status
-
Kennzeichnungen, die den Status dieser Funktion beschreiben. Ein Array, das eines oder mehrere der folgenden Elemente enthalten kann:
experimental,deprecated,non-standard. Dieser Schlüssel sollte nicht manuell festgelegt werden: Er wird automatisch anhand der Werte in den Browser-Kompatibilitätsdaten für die Funktion gesetzt. Siehe „Wie Funktionsstatus hinzugefügt oder aktualisiert werden“. - browser-compat
-
Ersetzen Sie den Platzhalterwert
javascript.builtins.Constructor.Constructordurch die Abfragezeichenfolge für den Konstruktor im Browser-Compat-Data-Repository. Die Toolchain verwendet den Schlüssel automatisch, um die Abschnitte zur Kompatibilität und Spezifikation auszufüllen (und ersetzt dabei die Makros{{Compat}}und{{Specifications}}).Beachten Sie, dass Sie möglicherweise zuerst einen Eintrag für den Konstruktor in unserem Browser-Compat-Data-Repository erstellen oder aktualisieren müssen und der Eintrag für die API Spezifikationsinformationen enthalten muss. Siehe unseren Leitfaden dazu.
-
Dies ist
jsreffür JavaScript-Konstruktorseiten. Einzelheiten finden Sie unter Seitenstrukturen: Sidebars.
Makros am Seitenanfang
Am Anfang des Inhaltsabschnitts (unmittelbar unter dem Frontmatter der Seite) erscheinen mehrere Makroaufrufe.
Diese Makros werden automatisch von der Toolchain hinzugefügt (es ist nicht notwendig, sie hinzuzufügen oder zu entfernen):
{{SeeCompatTable}}— dies erzeugt ein Banner Diese Technologie ist experimentell, das darauf hinweist, dass die Technologie experimentell ist. Wenn sie experimentell ist und die Technologie in Firefox hinter einer Pref verborgen ist, sollten Sie außerdem einen Eintrag dafür auf der Seite Experimentelle Funktionen in Firefox ausfüllen.{{Non-standard_Header}}— dies erzeugt ein Banner Nicht standardisiert, das darauf hinweist, dass die Funktion nicht Teil einer Spezifikation ist.
Geben Sie Status-Header-Makros nicht manuell an. Lesen Sie den Abschnitt Wie Funktionsstatus hinzugefügt oder aktualisiert werden, um diese Status zur Seite hinzuzufügen.
Beispiele der Banner Experimentell und Nicht standardisiert werden direkt nach diesem Anmerkungsblock angezeigt.
Denken Sie daran, diese gesamte erklärende Anmerkung vor der Veröffentlichung zu entfernen.
Hinweis: Denken Sie an das wichtigste Prinzip zum Schreiben konsistenter JavaScript-Referenzseiten: schauen Sie sich um! Viele verwandte Seiten haben über die Anforderungen dieser Vorlage hinaus konsistente Strukturen. Beispielsweise alle Proxy-Handler, die meisten Array-Methoden usw. Suchen Sie zunächst nach vorhandener Dokumentation für ähnliche APIs und kopieren Sie deren Struktur.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Der Konstruktor Constructor() erstellt {{jsxref("Constructor")}}-Objekte. (Genau dieser eine Satz, nicht mehr und nicht weniger)
Schreiben Sie ein interaktives Beispiel, das wichtige Aspekte des Konstruktors demonstriert.
Probieren Sie es aus
const obj = new Constructor();
console.log(obj.something);
// Expected output: 42
Syntax
Füllen Sie ein Syntaxfeld gemäß den Richtlinien in unserem Artikel zu Syntaxabschnitten aus.
new Constructor(parameter1)
new Constructor(parameter1, parameter2)
Fügen Sie für Konstruktoren außerdem die folgende Anmerkung ein:
Hinweis:
Constructor() kann nur mit new konstruiert werden. Der Versuch, ihn ohne new aufzurufen, löst einen TypeError aus.
(Einige ältere Konstruktoren haben eine andere Anmerkung, aber die Liste davon wird nicht wachsen, daher nehmen wir sie nicht in die Vorlage auf.)
Parameter
parameter1-
Fügen Sie hier eine kurze Beschreibung des Parameters und seiner Funktion ein. Fügen Sie für jeden Parameter einen Begriff und eine Definition hinzu. Wenn der Parameter nicht optional ist, entfernen Sie den Makroaufruf {{optional_inline}}.
parameter2Optional-
usw.
Hinweis: Dieser Abschnitt ist obligatorisch. Wenn es keine Parameter gibt, schreiben Sie statt der Definitionsliste „Keine.“.
Rückgabewert
Ein neues Constructor-Objekt, das ... repräsentiert.
Ausnahmen
TypeError-
Wird in einem der folgenden Fälle ausgelöst:
- Bedingung 1.
- Bedingung 2.
- usw.
RangeError-
Auslösen, wenn ...
Seien Sie so umfassend wie möglich. Listen Sie im Allgemeinen keine Ausnahmen auf, die durch das Ausführen von Benutzercode ausgelöst werden können, beispielsweise durch das Ausführen von Gettern oder durch Typkonvertierung. Listen Sie keine Ausnahmen aufgrund eines Typkonflikts auf, beispielsweise wenn ein Symbol an einen Parameter übergeben wird, der einen String erwartet, oder wenn eine Nicht-Funktion als Callback übergeben wird.
Beschreibung
Der Großteil der Beschreibung des Konstruktors sollte hier stehen. Seien Sie so umfassend wie möglich. Wenn viele Seiten dieselbe Beschreibung teilen, sollten Sie erwägen, einen neuen Abschnitt auf der Landingpage der Klasse hinzuzufügen und von hier darauf zu verlinken. Beispielsweise ist Array-Methoden und leere Slots von jeder Array-Methodenseite aus verlinkt.
Leser sollten die API anhand dieses Abschnitts vollständig verstehen können, ohne den folgenden Beispielabschnitt lesen zu müssen. Beispiele in diesem Abschnitt sollten, falls erforderlich, kurz sein und müssen keinen Bezug zur realen Welt haben.
Beispiele
Beachten Sie, dass wir den Plural „Beispiele“ verwenden, selbst wenn die Seite nur ein Beispiel enthält.
Eine beschreibende Überschrift
Jedes Beispiel muss eine H3-Überschrift haben, die das Beispiel benennt. Die Überschrift sollte beschreiben, was das Beispiel tut. Beispielsweise sagt „Ein einfaches Beispiel“ nichts über das Beispiel aus und ist daher keine gute Überschrift. Die Überschrift sollte kurz sein. Verwenden Sie für eine längere Beschreibung den Absatz nach der Überschrift. Das erste Beispiel kann „Verwenden des Constructor()-Konstruktors“ heißen.
Weitere Informationen finden Sie in unserem Leitfaden zum Hinzufügen von Codebeispielen.
Spezifikationen
{{Specifications}}
Um dieses Makro zu verwenden, entfernen Sie die Backticks und den Backslash in der Markdown-Datei.
Browser-Kompatibilität
{{Compat}}
Um dieses Makro zu verwenden, entfernen Sie die Backticks und den Backslash in der Markdown-Datei.
Siehe auch
Fügen Sie Links zu Referenzseiten und Leitfäden hinzu, die mit dem aktuellen Konstruktor zusammenhängen. Weitere Richtlinien finden Sie im Abschnitt „Siehe auch“ im Leitfaden zum Schreibstil.
- (Beachten Sie, dass Konstruktoren im Allgemeinen keine separaten Polyfill-Links benötigen, da sie auf der Hauptklassenseite dokumentiert sind.)
- link1
- link2
- external_link (year)