이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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`	노드를 상위 `Element` 노드에서 분리합니다.
`getAllContent()`	`Content[]`	{@code Element} 노드의 직계 하위 노드인 모든 노드를 가져옵니다.
`getAttribute(name)`	`Attribute`	지정된 이름을 가진 이 `Element` 노드의 속성을 가져옵니다(네임스페이스 없음).
`getAttribute(name, namespace)`	`Attribute`	지정된 이름과 네임스페이스를 사용하여 이 `Element` 노드의 속성을 가져옵니다.
`getAttributes()`	`Attribute[]`	이 `Element` 노드의 모든 속성을 문서에 표시되는 순서대로 가져옵니다.
`getChild(name)`	`Element`	지정된 이름을 가진 첫 번째 `Element` 노드와 이 `Element` 노드의 즉시 하위 요소인 네임스페이스가 없는 `Element` 노드를 가져옵니다.
`getChild(name, namespace)`	`Element`	이 `Element` 노드의 즉시 하위 요소인 지정된 이름과 네임스페이스를 가진 첫 번째 `Element` 노드를 가져옵니다.
`getChildText(name)`	`String`	노드가 `Element` 노드의 즉시 하위 노드인 경우 지정된 이름과 네임스페이스가 없는 노드의 텍스트 값을 가져옵니다.
`getChildText(name, namespace)`	`String`	노드가 `Element` 노드의 즉시 하위 노드인 경우 지정된 이름과 네임스페이스가 있는 노드의 텍스트 값을 가져옵니다.
`getChildren()`	`Element[]`	이 `Element` 노드의 즉시 하위 요소인 모든 `Element` 노드를 문서에 표시되는 순서대로 가져옵니다.
`getChildren(name)`	`Element[]`	이 `Element` 노드의 즉시 하위 요소인 네임스페이스가 없고 지정된 이름을 가진 모든 `Element` 노드를 문서에 표시되는 순서대로 가져옵니다.
`getChildren(name, namespace)`	`Element[]`	이 `Element` 노드의 즉시 하위 노드인 지정된 이름과 네임스페이스를 가진 모든 `Element` 노드를 문서에 표시되는 순서대로 가져옵니다.
`getContent(index)`	`Content`	{@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`	노드의 상위 `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`	{@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: 분리된 노드

`getAllContent()`

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

리턴

Content[]: {@code Element} 노드의 즉시 하위 노드인 모든 노드의 배열

`getAttribute(name)`

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

매개변수

이름	유형	설명
`name`	`String`	속성 이름

리턴

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

`getAttribute(name, namespace)`

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

매개변수

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

리턴

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

`getAttributes()`

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

리턴

Attribute[]: 이 Element 노드의 모든 속성 배열

`getChild(name)`

지정된 이름을 가진 첫 번째 Element 노드와 이 Element 노드의 즉시 하위 요소인 네임스페이스가 없는 Element 노드를 가져옵니다. 이러한 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`name`	`String`	하위 `Element` 노드의 이름

리턴

Element: Element 노드 또는 지정된 이름의 직속 하위 Element 노드가 없고 네임스페이스가 없는 경우 null

`getChild(name, namespace)`

이 Element 노드의 즉시 하위 요소인 지정된 이름과 네임스페이스를 가진 첫 번째 Element 노드를 가져옵니다. 이러한 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

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

리턴

Element: Element 노드 또는 지정된 이름과 네임스페이스를 가진 직속 하위 Element 노드가 없는 경우 null

`getChildText(name)`

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

매개변수

이름	유형	설명
`name`	`String`	하위 노드의 이름

리턴

String: 하위 노드의 텍스트 값입니다. 지정된 이름과 네임스페이스가 없는 즉시 하위 노드가 없는 경우 null입니다.

`getChildText(name, namespace)`

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

매개변수

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

리턴

String: 하위 노드의 텍스트 값 또는 지정된 이름과 네임스페이스를 가진 즉시 하위 노드가 없는 경우 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

`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: 상위 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

`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 노드의 로컬 이름을 설정합니다. 노드의 네임스페이스 접두사를 설정하려면 setNamespace(namespace)를 XmlService.getNamespace(prefix, uri)와 함께 사용합니다.

매개변수

이름	유형	설명
`name`	`String`	설정할 로컬 이름

리턴

Element: 체이닝을 위한 Element 노드

`setNamespace(namespace)`

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

매개변수

이름	유형	설명
`namespace`	`Namespace`	설정할 네임스페이스

리턴

Element: 체이닝을 위한 Element 노드

`setText(text)`

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

매개변수

이름	유형	설명
`text`	`String`	설정할 텍스트

리턴

Element: 체이닝을 위한 Element 노드