Class Element

Representasi node Element XML.

// Adds up the values listed in a sample XML document and adds a new element
// with the total.
let xml = '<things>' +
    '<plates>12</plates>' +
    '<bowls>18</bowls>' +
    '<cups>25</cups>' +
    '</things>';
const document = XmlService.parse(xml);
const root = document.getRootElement();
const items = root.getChildren();
let total = 0;
for (let i = 0; i < items.length; i++) {
  total += Number(items[i].getText());
}
const totalElement = XmlService.createElement('total').setText(total);
root.addContent(totalElement);
xml = XmlService.getPrettyFormat().format(document);
Logger.log(xml);

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
`addContent(content)`	`Element`	Menambahkan node yang diberikan sebagai turunan terakhir dari node `Element`.
`addContent(index, content)`	`Element`	Menyisipkan node tertentu pada indeks tertentu di antara semua node yang merupakan turunan langsung dari node `Element`.
`cloneContent()`	`Content[]`	Membuat salinan yang tidak terlampir dari semua node yang merupakan turunan langsung dari node {@code Element}.
`detach()`	`Content\|null`	Melepaskan node dari node induk `Element`.
`getAllContent()`	`Content[]`	Mendapatkan semua node yang merupakan turunan langsung dari node {@code Element}.
`getAttribute(name)`	`Attribute\|null`	Mendapatkan atribut untuk node `Element` ini dengan nama yang diberikan dan tanpa namespace.
`getAttribute(name, namespace)`	`Attribute\|null`	Mendapatkan atribut untuk node `Element` ini dengan nama dan namespace yang diberikan.
`getAttributes()`	`Attribute[]`	Mendapatkan semua atribut untuk node `Element` ini, dalam urutan yang muncul dalam dokumen.
`getChild(name)`	`Element\|null`	Mendapatkan node `Element` pertama dengan nama tertentu dan tanpa namespace yang merupakan turunan langsung dari node `Element` ini.
`getChild(name, namespace)`	`Element\|null`	Mendapatkan node `Element` pertama dengan nama dan namespace yang diberikan yang merupakan turunan langsung dari node `Element` ini.
`getChildText(name)`	`String\|null`	Mendapatkan nilai teks node dengan nama tertentu dan tanpa namespace, jika node adalah turunan langsung dari node `Element`.
`getChildText(name, namespace)`	`String\|null`	Mendapatkan nilai teks node dengan nama dan namespace tertentu, jika node adalah turunan langsung dari node `Element`.
`getChildren()`	`Element[]`	Mendapatkan semua node `Element` yang merupakan turunan langsung dari node `Element` ini, dalam urutan yang muncul dalam dokumen.
`getChildren(name)`	`Element[]`	Mendapatkan semua node `Element` dengan nama yang diberikan dan tanpa namespace yang merupakan turunan langsung dari node `Element` ini, dalam urutan yang muncul dalam dokumen.
`getChildren(name, namespace)`	`Element[]`	Mendapatkan semua node `Element` dengan nama dan namespace yang diberikan yang merupakan turunan langsung dari node `Element` ini, dalam urutan yang muncul dalam dokumen.
`getContent(index)`	`Content\|null`	Mendapatkan node pada indeks tertentu di antara semua node yang merupakan turunan langsung dari node {@code Element}.
`getContentSize()`	`Integer`	Mendapatkan jumlah node yang merupakan turunan langsung dari node {@code Element}.
`getDescendants()`	`Content[]`	Mendapatkan semua node yang merupakan turunan langsung atau tidak langsung dari node {@code Element}, dalam urutan yang ditampilkan dalam dokumen.
`getDocument()`	`Document`	Mendapatkan dokumen XML yang berisi node {@code Element}.
`getName()`	`String`	Mendapatkan nama lokal node `Element`.
`getNamespace()`	`Namespace`	Mendapatkan namespace untuk node `Element`.
`getNamespace(prefix)`	`Namespace`	Mendapatkan namespace dengan awalan yang diberikan untuk node `Element`.
`getParentElement()`	`Element\|null`	Mendapatkan node induk `Element` node.
`getQualifiedName()`	`String`	Mendapatkan nama lokal dan awalan namespace node `Element`, dalam bentuk `[namespacePrefix]:[localName]`.
`getText()`	`String`	Mendapatkan nilai teks node `Element`.
`getValue()`	`String`	Mendapatkan nilai teks semua node yang merupakan turunan langsung atau tidak langsung dari node, dalam urutan kemunculannya dalam dokumen.
`isAncestorOf(other)`	`Boolean`	Menentukan apakah node `Element` ini adalah induk langsung atau tidak langsung dari node `Element` tertentu.
`isRootElement()`	`Boolean`	Menentukan apakah node `Element` adalah node root dokumen.
`removeAttribute(attribute)`	`Boolean`	Menghapus atribut tertentu untuk node `Element` ini, jika atribut tersebut ada.
`removeAttribute(attributeName)`	`Boolean`	Menghapus atribut untuk node `Element` ini dengan nama yang diberikan dan tanpa namespace, jika atribut tersebut ada.
`removeAttribute(attributeName, namespace)`	`Boolean`	Menghapus atribut untuk node `Element` ini dengan nama dan namespace yang diberikan, jika atribut tersebut ada.
`removeContent()`	`Content[]`	Menghapus semua node yang merupakan turunan langsung dari node {@code Element}.
`removeContent(content)`	`Boolean`	Menghapus node yang diberikan, jika node tersebut adalah turunan langsung dari node {@code Element}.
`removeContent(index)`	`Content\|null`	Menghapus node pada indeks yang diberikan di antara semua node yang merupakan turunan langsung dari node {@code Element}.
`setAttribute(attribute)`	`Element`	Menetapkan atribut yang diberikan untuk node `Element` ini.
`setAttribute(name, value)`	`Element`	Menetapkan atribut untuk node `Element` ini dengan nama dan nilai yang diberikan, serta tanpa namespace.
`setAttribute(name, value, namespace)`	`Element`	Menetapkan atribut untuk node `Element` ini dengan nama, nilai, dan namespace yang diberikan.
`setName(name)`	`Element`	Menetapkan nama lokal node `Element`.
`setNamespace(namespace)`	`Element`	Menetapkan namespace untuk node `Element`.
`setText(text)`	`Element`	Menetapkan nilai teks node `Element`.

Dokumentasi mendetail

`addContent(content)`

Menambahkan node yang diberikan sebagai turunan terakhir dari node Element. Argumen content dapat berupa objek Element atau objek node apa pun yang sesuai dengan jenis yang tercantum dalam ContentType.

Parameter

Nama	Jenis	Deskripsi
`content`	`Content`	Node yang akan ditambahkan.

Pulang pergi

Element — Node Element, untuk pengaitan.

`addContent(index, content)`

Menyisipkan node tertentu pada indeks tertentu di antara semua node yang merupakan turunan langsung dari node Element. Argumen content dapat berupa objek Element atau objek node yang sesuai dengan jenis yang tercantum di ContentType.

Parameter

Nama	Jenis	Deskripsi
`index`	`Integer`	Indeks tempat untuk menyisipkan node di antara semua node yang merupakan turunan langsung dari node `Element`.
`content`	`Content`	Node yang akan disisipkan.

Pulang pergi

Element — Node Element, untuk pengaitan.

`cloneContent()`

Membuat salinan yang tidak terlampir dari semua node yang merupakan turunan langsung dari node {@code Element}.

Pulang pergi

Content[] — Array salinan yang tidak terlampir dari semua node yang merupakan turunan langsung dari node {@code Element}.

`detach()`

Melepaskan node dari node induk Element. Jika node tidak memiliki induk, metode ini tidak akan berpengaruh.

Pulang pergi

Content|null — Node yang dilepas.

`getAllContent()`

Mendapatkan semua node yang merupakan turunan langsung dari node {@code Element}.

Pulang pergi

Content[] — Array semua node yang merupakan turunan langsung dari node {@code Element}.

`getAttribute(name)`

Mendapatkan atribut untuk node Element ini dengan nama yang diberikan dan tanpa namespace. Jika tidak ada atribut tersebut, metode ini akan menampilkan null.

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama atribut.

Pulang pergi

Attribute|null — Atribut, atau null jika tidak ada atribut dengan nama yang diberikan dan tidak ada namespace.

`getAttribute(name, namespace)`

Mendapatkan atribut untuk node Element ini dengan nama dan namespace yang diberikan. Jika tidak ada node tersebut, metode ini akan menampilkan null.

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama atribut.
`namespace`	`Namespace`	Namespace atribut.

Pulang pergi

Attribute|null — Atribut, atau null jika tidak ada atribut dengan nama dan namespace yang diberikan.

`getAttributes()`

Mendapatkan semua atribut untuk node Element ini, dalam urutan yang muncul dalam dokumen.

Pulang pergi

Attribute[] — Array semua atribut untuk node Element ini.

`getChild(name)`

Mendapatkan node Element pertama dengan nama tertentu dan tanpa namespace yang merupakan turunan langsung dari node Element ini. Jika tidak ada node seperti itu, metode ini akan menampilkan null.

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama node `Element` turunan.

Pulang pergi

Element|null — Node Element, atau null jika tidak ada node Element turunan langsung dengan nama yang diberikan dan tidak ada namespace.

`getChild(name, namespace)`

Mendapatkan node Element pertama dengan nama dan namespace yang diberikan yang merupakan turunan langsung dari node Element ini. Jika tidak ada node seperti itu, metode ini akan menampilkan null.

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama node `Element` turunan.
`namespace`	`Namespace`	Namespace node turunan `Element`.

Pulang pergi

Element|null — Node Element, atau null jika tidak ada node Element turunan langsung dengan nama dan namespace yang diberikan.

`getChildText(name)`

Mendapatkan nilai teks node dengan nama tertentu dan tanpa namespace, jika node adalah turunan langsung dari node Element. Jika tidak ada node seperti itu, metode ini akan menampilkan null.

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama node turunan.

Pulang pergi

String|null — Nilai teks dari node turunan, atau null jika tidak ada node turunan langsung dengan nama yang diberikan dan tidak ada namespace.

`getChildText(name, namespace)`

Mendapatkan nilai teks node dengan nama dan namespace tertentu, jika node adalah turunan langsung dari node Element. Jika tidak ada node seperti itu, metode ini akan menampilkan null.

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama node turunan.
`namespace`	`Namespace`	Namespace node turunan.

Pulang pergi

String|null — Nilai teks dari node turunan, atau null jika tidak ada node turunan langsung dengan nama dan namespace yang diberikan.

`getChildren()`

Mendapatkan semua node Element yang merupakan turunan langsung dari node Element ini, dalam urutan yang muncul dalam dokumen.

Pulang pergi

Element[] — Array semua node Element yang merupakan turunan langsung dari node Element ini.

`getChildren(name)`

Mendapatkan semua node Element dengan nama yang diberikan dan tanpa namespace yang merupakan turunan langsung dari node Element ini, dalam urutan yang muncul dalam dokumen.

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama node turunan `Element`.

Pulang pergi

Element[] — Array semua node Element dengan nama tertentu dan tanpa namespace yang merupakan turunan langsung dari node Element ini.

`getChildren(name, namespace)`

Mendapatkan semua node Element dengan nama dan namespace yang diberikan yang merupakan turunan langsung dari node Element ini, dalam urutan yang muncul dalam dokumen.

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama node turunan `Element`.
`namespace`	`Namespace`	Namespace node turunan `Element`.

Pulang pergi

Element[] — Array semua node Element dengan nama dan namespace yang diberikan yang merupakan turunan langsung dari node Element ini.

`getContent(index)`

Mendapatkan node pada indeks tertentu di antara semua node yang merupakan turunan langsung dari node {@code Element}. Jika tidak ada node pada indeks yang diberikan, metode ini akan menampilkan null.

Parameter

Nama	Jenis	Deskripsi
`index`	`Integer`	Indeks untuk node di antara semua node yang merupakan turunan langsung dari node {@code Element}.

Pulang pergi

Content|null — Node, atau null jika tidak ada node pada indeks yang diberikan.

`getContentSize()`

Mendapatkan jumlah node yang merupakan turunan langsung dari node {@code Element}.

Pulang pergi

Integer — Jumlah node yang merupakan turunan langsung dari node {@code Element}.

`getDescendants()`

Mendapatkan semua node yang merupakan turunan langsung atau tidak langsung dari node {@code Element}, dalam urutan yang ditampilkan dalam dokumen.

Pulang pergi

Content[] — Array semua node yang merupakan turunan langsung atau tidak langsung dari node {@code Element}.

`getDocument()`

Mendapatkan dokumen XML yang berisi node {@code Element}.

Pulang pergi

Document — Dokumen yang berisi node {@code Element}.

`getName()`

Mendapatkan nama lokal node Element. Jika node memiliki awalan namespace, gunakan getQualifiedName() atau getNamespace().getPrefix() untuk mendapatkan awalan.

Pulang pergi

String — Nama lokal node Element.

`getNamespace()`

Mendapatkan namespace untuk node Element.

Pulang pergi

Namespace — Namespace untuk node Element.

`getNamespace(prefix)`

Mendapatkan namespace dengan awalan yang diberikan untuk node Element.

Parameter

Nama	Jenis	Deskripsi
`prefix`	`String`	Awalan untuk namespace.

Pulang pergi

Namespace — Namespace dengan awalan yang diberikan untuk node Element.

`getParentElement()`

Mendapatkan node induk Element node. Jika node tidak memiliki induk, metode ini akan menampilkan null.

Pulang pergi

Element|null — Node Element induk.

`getQualifiedName()`

Mendapatkan nama lokal dan awalan namespace node Element, dalam bentuk [namespacePrefix]:[localName]. Jika node tidak memiliki awalan namespace, gunakan getName().

Pulang pergi

String — Nama lokal dan awalan namespace dari node Element, dalam bentuk [namespacePrefix]:[localName].

`getText()`

Mendapatkan nilai teks node Element.

Pulang pergi

String — Nilai teks node Element.

`getValue()`

Mendapatkan nilai teks semua node yang merupakan turunan langsung atau tidak langsung dari node, dalam urutan kemunculannya dalam dokumen.

Pulang pergi

String — Nilai teks dari semua node yang merupakan turunan langsung atau tidak langsung dari node.

`isAncestorOf(other)`

Menentukan apakah node Element ini adalah induk langsung atau tidak langsung dari node Element tertentu.

Parameter

Nama	Jenis	Deskripsi
`other`	`Element`	Node `Element` lainnya.

Pulang pergi

Boolean — true jika node Element ini adalah induk langsung atau tidak langsung dari node Element yang diberikan; false jika tidak.

`isRootElement()`

Menentukan apakah node Element adalah node root dokumen.

Pulang pergi

Boolean — true jika node Element adalah node root dokumen; false jika tidak.

`removeAttribute(attribute)`

Menghapus atribut tertentu untuk node Element ini, jika atribut tersebut ada.

Parameter

Nama	Jenis	Deskripsi
`attribute`	`Attribute`	Atribut.

Pulang pergi

Boolean — true jika atribut ada dan dihapus; false jika tidak.

`removeAttribute(attributeName)`

Menghapus atribut untuk node Element ini dengan nama yang diberikan dan tanpa namespace, jika atribut tersebut ada.

Parameter

Nama	Jenis	Deskripsi
`attributeName`	`String`	Nama atribut.

Pulang pergi

Boolean — true jika atribut ada dan dihapus; false jika tidak.

`removeAttribute(attributeName, namespace)`

Menghapus atribut untuk node Element ini dengan nama dan namespace yang diberikan, jika atribut tersebut ada.

Parameter

Nama	Jenis	Deskripsi
`attributeName`	`String`	Nama atribut.
`namespace`	`Namespace`	Namespace atribut.

Pulang pergi

Boolean — true jika atribut ada dan dihapus; false jika tidak.

`removeContent()`

Menghapus semua node yang merupakan turunan langsung dari node {@code Element}.

Pulang pergi

Content[] — Array semua node yang merupakan turunan langsung dari node {@code Element} sebelum dihapus.

`removeContent(content)`

Menghapus node yang diberikan, jika node tersebut adalah turunan langsung dari node {@code Element}. Argumen content dapat berupa objek Element atau objek node apa pun yang sesuai dengan jenis yang tercantum dalam ContentType.

Parameter

Nama	Jenis	Deskripsi
`content`	`Content`	Node yang akan dihapus.

Pulang pergi

Boolean — true jika node adalah turunan langsung dan dihapus; false jika tidak.

`removeContent(index)`

Menghapus node pada indeks yang diberikan di antara semua node yang merupakan turunan langsung dari node {@code Element}. Jika tidak ada node pada indeks yang diberikan, metode ini akan menampilkan null.

Parameter

Nama	Jenis	Deskripsi
`index`	`Integer`	Indeks untuk node di antara semua node yang merupakan turunan langsung dari node {@code Element}.

Pulang pergi

Content|null — Node yang dihapus, atau null jika tidak ada node pada indeks yang diberikan.

`setAttribute(attribute)`

Menetapkan atribut yang diberikan untuk node Element ini.

Parameter

Nama	Jenis	Deskripsi
`attribute`	`Attribute`	Atribut yang akan ditetapkan.

Pulang pergi

Element — Node Element, untuk pengaitan.

`setAttribute(name, value)`

Menetapkan atribut untuk node Element ini dengan nama dan nilai yang diberikan, serta tanpa namespace.

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama atribut yang akan ditetapkan.
`value`	`String`	Nilai atribut yang akan ditetapkan.

Pulang pergi

Element — Node Element, untuk pengaitan.

`setAttribute(name, value, namespace)`

Menetapkan atribut untuk node Element ini dengan nama, nilai, dan namespace yang diberikan.

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama atribut yang akan ditetapkan.
`value`	`String`	Nilai atribut yang akan ditetapkan.
`namespace`	`Namespace`	Namespace atribut yang akan ditetapkan.

Pulang pergi

Element — Node Element, untuk pengaitan.

`setName(name)`

Menetapkan nama lokal node Element. Untuk menetapkan awalan namespace untuk node, gunakan setNamespace(namespace) bersama dengan XmlService.getNamespace(prefix, uri).

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama lokal yang akan ditetapkan.

Pulang pergi

Element — Node Element, untuk pengaitan.

`setNamespace(namespace)`

Menetapkan namespace untuk node Element.

Parameter

Nama	Jenis	Deskripsi
`namespace`	`Namespace`	Namespace yang akan ditetapkan.

Pulang pergi

Element — Node Element, untuk pengaitan.

`setText(text)`

Menetapkan nilai teks node Element. Jika node sudah berisi nilai teks atau node turunan, metode ini akan menimpa konten lama. Untuk menambahkan atau menyisipkan konten, gunakan addContent(content) atau addContent(index, content).

Parameter

Nama	Jenis	Deskripsi
`text`	`String`	Teks yang akan disetel.

Pulang pergi

Element — Node Element, untuk pengaitan.

Class Element Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Metode

Dokumentasi mendetail

addContent(content)

Parameter

Pulang pergi

addContent(index, content)

Parameter

Pulang pergi

cloneContent()

Pulang pergi

detach()

Pulang pergi

getAllContent()

Pulang pergi

getAttribute(name)

Parameter

Pulang pergi

getAttribute(name, namespace)

Parameter

Pulang pergi

getAttributes()

Pulang pergi

getChild(name)

Parameter

Pulang pergi

getChild(name, namespace)

Parameter

Pulang pergi

getChildText(name)

Parameter

Pulang pergi

getChildText(name, namespace)

Parameter

Pulang pergi

getChildren()

Pulang pergi

getChildren(name)

Parameter

Pulang pergi

getChildren(name, namespace)

Parameter

Pulang pergi

getContent(index)

Parameter

Pulang pergi

getContentSize()

Pulang pergi

getDescendants()

Pulang pergi

getDocument()

Pulang pergi

getName()

Pulang pergi

getNamespace()

Pulang pergi

getNamespace(prefix)

Parameter

Pulang pergi

getParentElement()

Pulang pergi

getQualifiedName()

Pulang pergi

getText()

Pulang pergi

getValue()

Pulang pergi

isAncestorOf(other)

Parameter

Pulang pergi

isRootElement()

Pulang pergi

removeAttribute(attribute)

Parameter

Pulang pergi

removeAttribute(attributeName)

Parameter

Pulang pergi

removeAttribute(attributeName, namespace)

Parameter

Class Element

`addContent(content)`

`addContent(index, content)`

`cloneContent()`

`detach()`

`getAllContent()`

`getAttribute(name)`

`getAttribute(name, namespace)`

`getAttributes()`

`getChild(name)`

`getChild(name, namespace)`

`getChildText(name)`

`getChildText(name, namespace)`

`getChildren()`

`getChildren(name)`

`getChildren(name, namespace)`

`getContent(index)`

`getContentSize()`

`getDescendants()`

`getDocument()`

`getName()`

`getNamespace()`

`getNamespace(prefix)`

`getParentElement()`

`getQualifiedName()`

`getText()`

`getValue()`

`isAncestorOf(other)`

`isRootElement()`

`removeAttribute(attribute)`

`removeAttribute(attributeName)`

`removeAttribute(attributeName, namespace)`

`removeContent()`

`removeContent(content)`

`removeContent(index)`

`setAttribute(attribute)`

`setAttribute(name, value)`

`setAttribute(name, value, namespace)`

`setName(name)`

`setNamespace(namespace)`

`setText(text)`