Class Element

XML Element 노드의 표현입니다.

// 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);

메서드

메서드	반환 유형	간략한 설명
`addContent(content)`	`Element`	지정된 노드를 `Element` 노드의 마지막 하위 요소로 추가합니다.
`addContent(index, content)`	`Element`	`Element` 노드의 직계 하위 요소인 모든 노드 중에서 지정된 색인에 지정된 노드를 삽입합니다.
`cloneContent()`	`Content[]`	{@code Element} 노드의 직계 하위 요소인 모든 노드의 연결되지 않은 사본을 만듭니다.
`detach()`	`Content\|null`	노드를 상위 `Element` 노드에서 분리합니다.
`getAllContent()`	`Content[]`	{@code Element} 노드의 직계 하위 노드를 모두 가져옵니다.
`getAttribute(name)`	`Attribute\|null`	지정된 이름과 네임스페이스가 없는 이 `Element` 노드의 속성을 가져옵니다.
`getAttribute(name, namespace)`	`Attribute\|null`	지정된 이름과 네임스페이스를 사용하여 이 `Element` 노드의 속성을 가져옵니다.
`getAttributes()`	`Attribute[]`	문서에 표시되는 순서대로 이 `Element` 노드의 모든 속성을 가져옵니다.
`getChild(name)`	`Element\|null`	지정된 이름과 네임스페이스가 없으며 이 `Element` 노드의 직계 자식인 첫 번째 `Element` 노드를 가져옵니다.
`getChild(name, namespace)`	`Element\|null`	이 `Element` 노드의 직계 자식인 지정된 이름과 네임스페이스를 가진 첫 번째 `Element` 노드를 가져옵니다.
`getChildText(name)`	`String\|null`	노드가 `Element` 노드의 직계 자식인 경우 지정된 이름과 네임스페이스가 없는 노드의 텍스트 값을 가져옵니다.
`getChildText(name, namespace)`	`String\|null`	노드가 `Element` 노드의 직계 자식인 경우 지정된 이름과 네임스페이스가 있는 노드의 텍스트 값을 가져옵니다.
`getChildren()`	`Element[]`	이 `Element` 노드의 직계 하위 항목인 모든 `Element` 노드를 문서에 표시되는 순서대로 가져옵니다.
`getChildren(name)`	`Element[]`	이 `Element` 노드의 직계 하위 항목이며 지정된 이름이 있고 네임스페이스가 없는 모든 `Element` 노드를 문서에 표시되는 순서대로 가져옵니다.
`getChildren(name, namespace)`	`Element[]`	이 `Element` 노드의 직계 하위 항목이며 지정된 이름과 네임스페이스가 있는 모든 `Element` 노드를 문서에 표시되는 순서대로 가져옵니다.
`getContent(index)`	`Content\|null`	{@code Element} 노드의 직계 하위 노드인 모든 노드 중에서 지정된 색인의 노드를 가져옵니다.
`getContentSize()`	`Integer`	{@code Element} 노드의 직계 하위 노드 수를 가져옵니다.
`getDescendants()`	`Content[]`	{@code Element} 노드의 직접 또는 간접 하위 노드를 문서에 표시되는 순서대로 가져옵니다.
`getDocument()`	`Document`	{@code Element} 노드를 포함하는 XML 문서를 가져옵니다.
`getName()`	`String`	`Element` 노드의 로컬 이름을 가져옵니다.
`getNamespace()`	`Namespace`	`Element` 노드의 네임스페이스를 가져옵니다.
`getNamespace(prefix)`	`Namespace`	`Element` 노드의 지정된 접두사가 있는 네임스페이스를 가져옵니다.
`getParentElement()`	`Element\|null`	노드의 상위 `Element` 노드를 가져옵니다.
`getQualifiedName()`	`String`	`Element` 노드의 로컬 이름과 네임스페이스 접두사를 `[namespacePrefix]:[localName]` 형식으로 가져옵니다.
`getText()`	`String`	`Element` 노드의 텍스트 값을 가져옵니다.
`getValue()`	`String`	문서에 표시되는 순서대로 노드의 직계 또는 비직계 하위 요소인 모든 노드의 텍스트 값을 가져옵니다.
`isAncestorOf(other)`	`Boolean`	이 `Element` 노드가 지정된 `Element` 노드의 직접 또는 간접 상위 요소인지 확인합니다.
`isRootElement()`	`Boolean`	`Element` 노드가 문서의 루트 노드인지 확인합니다.
`removeAttribute(attribute)`	`Boolean`	이 `Element` 노드에 지정된 속성이 있는 경우 삭제합니다.
`removeAttribute(attributeName)`	`Boolean`	이름이 지정되고 네임스페이스가 없는 이 `Element` 노드의 속성을 삭제합니다(이러한 속성이 있는 경우).
`removeAttribute(attributeName, namespace)`	`Boolean`	이 `Element` 노드의 속성을 지정된 이름과 네임스페이스로 삭제합니다(이러한 속성이 있는 경우).
`removeContent()`	`Content[]`	{@code Element} 노드의 직계 하위 노드를 모두 삭제합니다.
`removeContent(content)`	`Boolean`	노드가 {@code Element} 노드의 바로 아래 하위 노드인 경우 지정된 노드를 삭제합니다.
`removeContent(index)`	`Content\|null`	{@code Element} 노드의 직계 하위 노드 중 지정된 색인의 노드를 삭제합니다.
`setAttribute(attribute)`	`Element`	이 `Element` 노드의 지정된 속성을 설정합니다.
`setAttribute(name, value)`	`Element`	지정된 이름, 값, 네임스페이스가 없는 이 `Element` 노드의 속성을 설정합니다.
`setAttribute(name, value, namespace)`	`Element`	지정된 이름, 값, 네임스페이스로 이 `Element` 노드의 속성을 설정합니다.
`setName(name)`	`Element`	`Element` 노드의 로컬 이름을 설정합니다.
`setNamespace(namespace)`	`Element`	`Element` 노드의 네임스페이스를 설정합니다.
`setText(text)`	`Element`	`Element` 노드의 텍스트 값을 설정합니다.

자세한 문서

`addContent(content)`

지정된 노드를 Element 노드의 마지막 하위 요소로 추가합니다. content 인수는 Element 객체이거나 ContentType에 나열된 유형에 해당하는 노드 객체일 수 있습니다.

매개변수

이름	유형	설명
`content`	`Content`	추가할 노드입니다.

리턴

Element - 체이닝을 위한 Element 노드

`addContent(index, content)`

Element 노드의 직계 하위 요소인 모든 노드 중에서 지정된 색인에 지정된 노드를 삽입합니다. content 인수는 Element 객체이거나 ContentType에 나열된 유형에 해당하는 노드 객체일 수 있습니다.

매개변수

이름	유형	설명
`index`	`Integer`	`Element` 노드의 직계 하위 노드인 모든 노드 사이에 노드를 삽입할 인덱스입니다.
`content`	`Content`	삽입할 노드입니다.

리턴

Element - 체이닝을 위한 Element 노드

`cloneContent()`

{@code Element} 노드의 직계 하위 요소인 모든 노드의 연결되지 않은 사본을 만듭니다.

리턴

Content[] - {@code Element} 노드의 직계 하위 항목인 모든 노드의 연결되지 않은 복사본 배열입니다.

`detach()`

노드를 상위 Element 노드에서 분리합니다. 노드에 상위 요소가 없으면 이 메서드는 효과가 없습니다.

리턴

Content|null - 분리된 노드입니다.

`getAllContent()`

{@code Element} 노드의 직계 하위 노드를 모두 가져옵니다.

리턴

Content[] - {@code Element} 노드의 직계 하위 요소인 모든 노드의 배열입니다.

`getAttribute(name)`

지정된 이름과 네임스페이스가 없는 이 Element 노드의 속성을 가져옵니다. 이러한 속성이 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`name`	`String`	속성 이름입니다.

리턴

Attribute|null - 속성 또는 지정된 이름의 속성이 없고 네임스페이스가 없는 경우 null

`getAttribute(name, namespace)`

지정된 이름과 네임스페이스를 사용하여 이 Element 노드의 속성을 가져옵니다. 이러한 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`name`	`String`	속성 이름입니다.
`namespace`	`Namespace`	속성의 네임스페이스입니다.

리턴

Attribute|null - 속성 또는 지정된 이름과 네임스페이스가 있는 속성이 없는 경우 null

`getAttributes()`

문서에 표시되는 순서대로 이 Element 노드의 모든 속성을 가져옵니다.

리턴

Attribute[] - 이 Element 노드의 모든 속성 배열입니다.

`getChild(name)`

지정된 이름과 네임스페이스가 없으며 이 Element 노드의 직계 자식인 첫 번째 Element 노드를 가져옵니다. 이러한 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`name`	`String`	하위 `Element` 노드의 이름입니다.

리턴

Element|null - Element 노드 또는 지정된 이름과 네임스페이스가 있는 직계 하위 Element 노드가 없는 경우 null

`getChild(name, namespace)`

이 Element 노드의 직계 자식인 지정된 이름과 네임스페이스를 가진 첫 번째 Element 노드를 가져옵니다. 이러한 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`name`	`String`	하위 `Element` 노드의 이름입니다.
`namespace`	`Namespace`	하위 `Element` 노드의 네임스페이스입니다.

리턴

Element|null - Element 노드 또는 지정된 이름과 네임스페이스가 있는 직계 하위 Element 노드가 없는 경우 null

`getChildText(name)`

노드가 Element 노드의 직계 자식인 경우 지정된 이름과 네임스페이스가 없는 노드의 텍스트 값을 가져옵니다. 이러한 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`name`	`String`	하위 노드의 이름입니다.

리턴

String|null - 하위 노드의 텍스트 값입니다. 지정된 이름과 네임스페이스가 있는 직계 하위 노드가 없는 경우 null입니다.

`getChildText(name, namespace)`

노드가 Element 노드의 직계 자식인 경우 지정된 이름과 네임스페이스가 있는 노드의 텍스트 값을 가져옵니다. 이러한 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`name`	`String`	하위 노드의 이름입니다.
`namespace`	`Namespace`	하위 노드의 네임스페이스입니다.

리턴

String|null - 하위 노드의 텍스트 값입니다. 지정된 이름과 네임스페이스를 가진 직계 하위 노드가 없는 경우 null입니다.

`getChildren()`

이 Element 노드의 직계 하위 항목인 모든 Element 노드를 문서에 표시되는 순서대로 가져옵니다.

리턴

Element[] - 이 Element 노드의 직계 하위 요소인 모든 Element 노드의 배열입니다.

`getChildren(name)`

이 Element 노드의 직계 하위 항목이며 지정된 이름이 있고 네임스페이스가 없는 모든 Element 노드를 문서에 표시되는 순서대로 가져옵니다.

매개변수

이름	유형	설명
`name`	`String`	하위 `Element` 노드의 이름입니다.

리턴

Element[] - 지정된 이름과 네임스페이스가 없으며 이 Element 노드의 직계 하위 요소인 모든 Element 노드의 배열입니다.

`getChildren(name, namespace)`

이 Element 노드의 직계 하위 항목이며 지정된 이름과 네임스페이스가 있는 모든 Element 노드를 문서에 표시되는 순서대로 가져옵니다.

매개변수

이름	유형	설명
`name`	`String`	하위 `Element` 노드의 이름입니다.
`namespace`	`Namespace`	하위 `Element` 노드의 네임스페이스입니다.

리턴

Element[] - 지정된 이름과 네임스페이스를 가지며 이 Element 노드의 직계 하위 요소인 모든 Element 노드의 배열입니다.

`getContent(index)`

{@code Element} 노드의 직계 하위 노드인 모든 노드 중에서 지정된 색인의 노드를 가져옵니다. 지정된 색인에 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`index`	`Integer`	{@code Element} 노드의 직계 하위 노드 중 노드의 색인입니다.

리턴

Content|null - 노드 또는 지정된 색인에 노드가 없는 경우 null

`getContentSize()`

{@code Element} 노드의 직계 하위 노드 수를 가져옵니다.

리턴

Integer - {@code Element} 노드의 직계 하위 노드 수입니다.

`getDescendants()`

{@code Element} 노드의 직접 또는 간접 하위 노드를 문서에 표시되는 순서대로 가져옵니다.

리턴

Content[] - {@code Element} 노드의 직접 또는 간접 하위 요소인 모든 노드의 배열입니다.

`getDocument()`

{@code Element} 노드를 포함하는 XML 문서를 가져옵니다.

리턴

Document - {@code Element} 노드가 포함된 문서입니다.

`getName()`

Element 노드의 로컬 이름을 가져옵니다. 노드에 네임스페이스 접두사가 있으면 getQualifiedName() 또는 getNamespace()를 사용합니다.getPrefix()를 사용하여 접두사를 가져옵니다.

리턴

String - Element 노드의 로컬 이름입니다.

`getNamespace()`

Element 노드의 네임스페이스를 가져옵니다.

리턴

Namespace - Element 노드의 네임스페이스입니다.

`getNamespace(prefix)`

Element 노드의 지정된 접두사가 있는 네임스페이스를 가져옵니다.

매개변수

이름	유형	설명
`prefix`	`String`	네임스페이스의 접두사입니다.

리턴

Namespace - Element 노드의 지정된 접두사가 있는 네임스페이스입니다.

`getParentElement()`

노드의 상위 Element 노드를 가져옵니다. 노드에 상위 요소가 없으면 이 메서드는 null을 반환합니다.

리턴

Element|null - 상위 Element 노드입니다.

`getQualifiedName()`

Element 노드의 로컬 이름과 네임스페이스 접두사를 [namespacePrefix]:[localName] 형식으로 가져옵니다. 노드에 네임스페이스 접두사가 없는 경우 getName()을 사용합니다.

리턴

String - Element 노드의 로컬 이름과 네임스페이스 접두사입니다([namespacePrefix]:[localName] 형식).

`getText()`

Element 노드의 텍스트 값을 가져옵니다.

리턴

String: Element 노드의 텍스트 값입니다.

`getValue()`

문서에 표시되는 순서대로 노드의 직계 또는 비직계 하위 요소인 모든 노드의 텍스트 값을 가져옵니다.

리턴

String - 노드의 직간접 하위 요소인 모든 노드의 텍스트 값입니다.

`isAncestorOf(other)`

이 Element 노드가 지정된 Element 노드의 직접 또는 간접 상위 요소인지 확인합니다.

매개변수

이름	유형	설명
`other`	`Element`	다른 `Element` 노드입니다.

리턴

Boolean - 이 Element 노드가 지정된 Element 노드의 직접 또는 간접 상위 요소인 경우 true, 그렇지 않은 경우 false

`isRootElement()`

Element 노드가 문서의 루트 노드인지 확인합니다.

리턴

Boolean - Element 노드가 문서의 루트 노드인 경우 true, 그렇지 않은 경우 false

`removeAttribute(attribute)`

이 Element 노드에 지정된 속성이 있는 경우 삭제합니다.

매개변수

이름	유형	설명
`attribute`	`Attribute`	속성입니다.

리턴

Boolean - 속성이 존재하여 삭제된 경우 true, 그렇지 않은 경우 false

`removeAttribute(attributeName)`

이름이 지정되고 네임스페이스가 없는 이 Element 노드의 속성을 삭제합니다(이러한 속성이 있는 경우).

매개변수

이름	유형	설명
`attributeName`	`String`	속성 이름입니다.

리턴

Boolean - 속성이 존재하여 삭제된 경우 true, 그렇지 않은 경우 false

`removeAttribute(attributeName, namespace)`

이 Element 노드의 속성을 지정된 이름과 네임스페이스로 삭제합니다(이러한 속성이 있는 경우).

매개변수

이름	유형	설명
`attributeName`	`String`	속성 이름입니다.
`namespace`	`Namespace`	속성의 네임스페이스입니다.

리턴

Boolean - 속성이 존재하여 삭제된 경우 true, 그렇지 않은 경우 false

`removeContent()`

{@code Element} 노드의 직계 하위 노드를 모두 삭제합니다.

리턴

Content[] - 삭제되기 전 {@code Element} 노드의 직계 하위 노드였던 모든 노드의 배열입니다.

`removeContent(content)`

노드가 {@code Element} 노드의 바로 아래 하위 노드인 경우 지정된 노드를 삭제합니다. content 인수는 Element 객체이거나 ContentType에 나열된 유형에 해당하는 노드 객체일 수 있습니다.

매개변수

이름	유형	설명
`content`	`Content`	삭제할 노드입니다.

리턴

Boolean - 노드가 직계 하위 요소이고 삭제된 경우 true, 그렇지 않은 경우 false

`removeContent(index)`

{@code Element} 노드의 직계 하위 노드 중 지정된 색인의 노드를 삭제합니다. 지정된 색인에 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`index`	`Integer`	{@code Element} 노드의 직계 하위 노드 중 노드의 색인입니다.

리턴

Content|null - 삭제된 노드 또는 지정된 색인에 노드가 없는 경우 null

`setAttribute(attribute)`

이 Element 노드의 지정된 속성을 설정합니다.

매개변수

이름	유형	설명
`attribute`	`Attribute`	설정할 속성입니다.

리턴

Element - 체이닝을 위한 Element 노드

`setAttribute(name, value)`

지정된 이름, 값, 네임스페이스가 없는 이 Element 노드의 속성을 설정합니다.

매개변수

이름	유형	설명
`name`	`String`	설정할 속성의 이름입니다.
`value`	`String`	설정할 속성의 값입니다.

리턴

Element - 체이닝을 위한 Element 노드

`setAttribute(name, value, namespace)`

지정된 이름, 값, 네임스페이스로 이 Element 노드의 속성을 설정합니다.

매개변수

이름	유형	설명
`name`	`String`	설정할 속성의 이름입니다.
`value`	`String`	설정할 속성의 값입니다.
`namespace`	`Namespace`	설정할 속성의 네임스페이스입니다.

리턴

Element - 체이닝을 위한 Element 노드

`setName(name)`

Element 노드의 로컬 이름을 설정합니다. 노드의 네임스페이스 접두사를 설정하려면 XmlService.getNamespace(prefix, uri)와 함께 setNamespace(namespace)를 사용합니다.

매개변수

이름	유형	설명
`name`	`String`	설정할 현지 이름입니다.

리턴

Element - 체이닝을 위한 Element 노드

`setNamespace(namespace)`

Element 노드의 네임스페이스를 설정합니다.

매개변수

이름	유형	설명
`namespace`	`Namespace`	설정할 네임스페이스입니다.

리턴

Element - 체이닝을 위한 Element 노드

`setText(text)`

Element 노드의 텍스트 값을 설정합니다. 노드에 이미 텍스트 값이나 하위 노드가 포함되어 있으면 이 메서드는 이전 콘텐츠를 덮어씁니다. 대신 콘텐츠를 추가하거나 삽입하려면 addContent(content) 또는 addContent(index, content)를 사용하세요.

매개변수

이름	유형	설명
`text`	`String`	설정할 텍스트입니다.

리턴

Element - 체이닝을 위한 Element 노드

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)

매개변수

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)`