Class Element

Elemen

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

MetodeJenis hasil yang ditampilkanDeskripsi singkat
addContent(content)ElementMenambahkan node yang diberikan sebagai turunan terakhir dari node Element.
addContent(index, content)ElementMenyisipkan node yang diberikan pada indeks yang diberikan di antara semua node yang merupakan turunan langsung dari node Element.
cloneContent()Content[]Membuat salinan yang tidak terpasang dari semua node yang merupakan turunan langsung dari node {@code Element}.
detach()ContentMelepas node dari node Element induknya.
getAllContent()Content[]Mendapatkan semua node yang merupakan turunan langsung dari node {@code Element}.
getAttribute(name)AttributeMendapatkan atribut untuk node Element ini dengan nama yang diberikan dan tanpa namespace.
getAttribute(name, namespace)AttributeMendapatkan 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)ElementMendapatkan node Element pertama dengan nama yang diberikan dan tanpa namespace yang merupakan turunan langsung dari node Element ini.
getChild(name, namespace)ElementMendapatkan node Element pertama dengan nama dan namespace yang diberikan yang merupakan turunan langsung dari node Element ini.
getChildText(name)StringMendapatkan nilai teks node dengan nama yang diberikan dan tanpa namespace, jika node adalah turunan langsung dari node Element.
getChildText(name, namespace)StringMendapatkan nilai teks node dengan nama dan namespace yang diberikan, jika node adalah turunan langsung 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 tidak ada namespace yang merupakan turunan langsung 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)ContentMendapatkan node pada indeks yang diberikan di antara semua node yang merupakan turunan langsung dari node {@code Element}.
getContentSize()IntegerMendapatkan 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 muncul dalam dokumen.
getDocument()DocumentMendapatkan dokumen XML yang berisi node {@code Element}.
getName()StringMendapatkan nama lokal node Element.
getNamespace()NamespaceMendapatkan namespace untuk node Element.
getNamespace(prefix)NamespaceMendapatkan namespace dengan awalan yang diberikan untuk node Element.
getParentElement()ElementMendapatkan node Element induk node.
getQualifiedName()StringMendapatkan nama lokal dan awalan namespace node Element, dalam bentuk [namespacePrefix]:[localName].
getText()StringMendapatkan nilai teks node Element.
getValue()StringMendapatkan nilai teks dari semua node yang merupakan turunan langsung atau tidak langsung dari node, dalam urutan munculnya dalam dokumen.
isAncestorOf(other)BooleanMenentukan apakah node Element ini adalah induk langsung atau tidak langsung dari node Element tertentu.
isRootElement()BooleanMenentukan apakah node Element adalah node root dokumen.
removeAttribute(attribute)BooleanMenghapus atribut yang diberikan untuk node Element ini, jika atribut tersebut ada.
removeAttribute(attributeName)BooleanMenghapus atribut untuk node Element ini dengan nama yang diberikan dan tanpa namespace, jika atribut tersebut ada.
removeAttribute(attributeName, namespace)BooleanMenghapus 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)BooleanMenghapus node yang diberikan, jika node tersebut merupakan turunan langsung dari node {@code Element}.
removeContent(index)ContentMenghapus node pada indeks yang diberikan di antara semua node yang merupakan turunan langsung dari node {@code Element}.
setAttribute(attribute)ElementMenetapkan atribut yang diberikan untuk node Element ini.
setAttribute(name, value)ElementMenetapkan atribut untuk node Element ini dengan nama, nilai, dan tanpa namespace yang diberikan.
setAttribute(name, value, namespace)ElementMenetapkan atribut untuk node Element ini dengan nama, nilai, dan namespace yang diberikan.
setName(name)ElementMenetapkan nama lokal node Element.
setNamespace(namespace)ElementMenetapkan namespace untuk node Element.
setText(text)ElementMenetapkan 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

NamaJenisDeskripsi
contentContentnode yang akan ditambahkan

Pulang pergi

Element — node Element, untuk pembuatan rantai

addContent(index, content)

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

Parameter

NamaJenisDeskripsi
indexIntegerindeks tempat menyisipkan node di antara semua node yang merupakan turunan langsung dari node Element
contentContentnode yang akan disisipkan

Pulang pergi

Element — node Element, untuk pembuatan rantai

cloneContent()

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

Pulang pergi

Content[] — array salinan yang tidak terpasang dari semua node yang merupakan turunan langsung dari node {@code Element}

detach()

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

Pulang pergi

Content — node yang terpisah

getAllContent()

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

Pulang pergi

Content[] — array dari 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

NamaJenisDeskripsi
nameStringnama atribut

Pulang pergi

Attribute — 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

NamaJenisDeskripsi
nameStringnama atribut
namespaceNamespacenamespace atribut

Pulang pergi

Attribute — atribut, atau null jika tidak ada atribut dengan nama dan namespaces 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 yang diberikan dan tanpa namespace yang merupakan turunan langsung dari node Element ini. Jika tidak ada node tersebut, metode ini akan menampilkan null.

Parameter

NamaJenisDeskripsi
nameStringnama node Element turunan

Pulang pergi

Element — 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 tersebut, metode ini akan menampilkan null.

Parameter

NamaJenisDeskripsi
nameStringnama node Element turunan
namespaceNamespacenamespace node Element turunan

Pulang pergi

Element — 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 yang diberikan dan tanpa namespace, jika node adalah turunan langsung dari node Element. Jika tidak ada node tersebut, metode ini akan menampilkan null.

Parameter

NamaJenisDeskripsi
nameStringnama node turunan

Pulang pergi

String — nilai teks 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 yang diberikan, jika node adalah turunan langsung node Element. Jika tidak ada node tersebut, metode ini akan menampilkan null.

Parameter

NamaJenisDeskripsi
nameStringnama node turunan
namespaceNamespacenamespace node turunan

Pulang pergi

String — nilai teks 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 dari semua node Element yang merupakan turunan langsung dari node Element ini

getChildren(name)

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

Parameter

NamaJenisDeskripsi
nameStringnama node Element turunan

Pulang pergi

Element[] — array dari semua node Element dengan nama yang diberikan 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

NamaJenisDeskripsi
nameStringnama node Element turunan
namespaceNamespacenamespace node Element turunan

Pulang pergi

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

getContent(index)

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

Parameter

NamaJenisDeskripsi
indexIntegerindeks untuk node di antara semua node yang merupakan turunan langsung dari node {@code Element}

Pulang pergi

Content — node, atau null jika tidak ada node di 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 muncul dalam dokumen.

Pulang pergi

Content[] — array dari 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

NamaJenisDeskripsi
prefixStringawalan untuk namespace

Pulang pergi

Namespace — namespace dengan awalan yang diberikan untuk node Element

getParentElement()

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

Pulang pergi

Element — 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 node Element, dalam bentuk [namespacePrefix]:[localName]

getText()

Mendapatkan nilai teks node Element.

Pulang pergi

String — nilai teks node Element

getValue()

Mendapatkan nilai teks dari semua node yang merupakan turunan langsung atau tidak langsung dari node, dalam urutan munculnya 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

NamaJenisDeskripsi
otherElementnode 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 yang diberikan untuk node Element ini, jika atribut tersebut ada.

Parameter

NamaJenisDeskripsi
attributeAttributeatribut

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

NamaJenisDeskripsi
attributeNameStringnama 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

NamaJenisDeskripsi
attributeNameStringnama atribut
namespaceNamespacenamespace 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 dari semua node yang merupakan turunan langsung dari node {@code Element} sebelum dihapus

removeContent(content)

Menghapus node yang diberikan, jika node tersebut merupakan 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

NamaJenisDeskripsi
contentContentnode 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 di indeks yang diberikan, metode ini akan menampilkan null.

Parameter

NamaJenisDeskripsi
indexIntegerindeks untuk node di antara semua node yang merupakan turunan langsung dari node {@code Element}

Pulang pergi

Content — node yang dihapus, atau null jika tidak ada node di indeks yang diberikan

setAttribute(attribute)

Menetapkan atribut yang diberikan untuk node Element ini.

Parameter

NamaJenisDeskripsi
attributeAttributeatribut yang akan ditetapkan

Pulang pergi

Element — node Element, untuk pembuatan rantai

setAttribute(name, value)

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

Parameter

NamaJenisDeskripsi
nameStringnama atribut yang akan ditetapkan
valueStringnilai atribut yang akan ditetapkan

Pulang pergi

Element — node Element, untuk pembuatan rantai

setAttribute(name, value, namespace)

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

Parameter

NamaJenisDeskripsi
nameStringnama atribut yang akan ditetapkan
valueStringnilai atribut yang akan ditetapkan
namespaceNamespacenamespace atribut yang akan ditetapkan

Pulang pergi

Element — node Element, untuk pembuatan rantai

setName(name)

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

Parameter

NamaJenisDeskripsi
nameStringnama lokal yang akan ditetapkan

Pulang pergi

Element — node Element, untuk pembuatan rantai

setNamespace(namespace)

Menetapkan namespace untuk node Element.

Parameter

NamaJenisDeskripsi
namespaceNamespacenamespace yang akan ditetapkan

Pulang pergi

Element — node Element, untuk pembuatan rantai

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

NamaJenisDeskripsi
textStringteks yang akan ditetapkan

Pulang pergi

Element — node Element, untuk pembuatan rantai