From 47b4da9ba14b8b735e0d5d33f580b774dce43fc1 Mon Sep 17 00:00:00 2001
From: Gusborg <91546896+gusborg88@users.noreply.github.com>
Date: Mon, 30 Sep 2024 15:49:11 -0500
Subject: [PATCH] Add HTMLMediaElement.addTextTrack() (#36100)

* made an addTextTrack() page

* Forgot a right brace

whoopsie daisies

* Moved usage notes to intro

* i did not add that I what the hell

* the add to batch button wasnt working so im doing this

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>

* the add to batch button wasnt working so im doing this

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>

* the add to batch button wasnt working so im doing this

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>

* the add to batch button wasnt working so im doing this

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>

* Update files/en-us/web/api/htmlmediaelement/addtexttrack/index.md

* Apply suggestions from code review

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>

* Fixed problem in example

---------

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
---
 .../htmlmediaelement/addtexttrack/index.md    | 64 +++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 files/en-us/web/api/htmlmediaelement/addtexttrack/index.md

diff --git a/files/en-us/web/api/htmlmediaelement/addtexttrack/index.md b/files/en-us/web/api/htmlmediaelement/addtexttrack/index.md
new file mode 100644
index 000000000000000..658821bdc5dc8fc
--- /dev/null
+++ b/files/en-us/web/api/htmlmediaelement/addtexttrack/index.md
@@ -0,0 +1,64 @@
+---
+title: "HTMLMediaElement: addTextTrack() method"
+short-title: addTextTrack()
+slug: Web/API/HTMLMediaElement/addTextTrack
+page-type: web-api-instance-method
+browser-compat: api.HTMLMediaElement.addTextTrack
+---
+
+{{APIRef("HTML DOM")}}
+
+The **`addTextTrack()`** method of the {{domxref("HTMLMediaElement")}} interface creates a new {{domxref("TextTrack")}} object and adds it to the media element. It fires an {{domxref("TextTrackList/addtrack_event", "addtrack")}} event on this media element's {{domxref("HTMLMediaElement/textTracks", "textTracks")}}. This method can't be used on a {{domxref("TextTrackList")}} interface, only an {{domxref("HTMLMediaElement")}}.
+
+## Syntax
+
+```js-nolint
+addTextTrack(kind)
+addTextTrack(kind, label)
+addTextTrack(kind, label, language)
+```
+
+### Parameters
+
+- `kind`
+  - : A string representing the {{domxref("TextTrack.kind")}} property (`subtitles`, `captions`, `descriptions`, `chapters`, or `metadata`).
+- `label`
+  - : A string representing the {{domxref("TextTrack.label")}} property.
+- `language`
+  - : A string representing the {{domxref("TextTrack.language")}} property.
+
+### Return value
+
+The newly created {{domxref("TextTrack")}} object.
+
+### Exceptions
+
+None.
+
+## Examples
+
+This example adds a new {{domxref("TextTrack")}} with the `kind` set to `"subtitles"`, and adds a new {{domxref("VTTCue")}} to that.
+
+```js
+const video = document.querySelector("video");
+const newTrack = video.addTextTrack("subtitles");
+newTrack.addCue(new VTTCue(3, 6, "Hello world!"));
+console.log(newTrack.cues[0].text);
+// "Hello world!"
+```
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}
+
+## See also
+
+- {{domxref("TextTrack")}}
+- [WebVTT API](/en-US/docs/Web/API/WebVTT_API)
+- [Web media technologies](/en-US/docs/Web/Media)
+- Learning: [Video and audio content](/en-US/docs/Learn/HTML/Multimedia_and_embedding/Video_and_audio_content)
+- [Using the Web Audio API](/en-US/docs/Web/API/Web_Audio_API/Using_Web_Audio_API)