enumLabels()

Returns a list of all currently defined labels...

Syntax

var list = enumLabels();

Parameters

The function has no parameters.

Return value

Value Type Description Game version

<list>

Array of String

A list of label names currently registered with the JS API.

Use label() to get the object associated with a label.

3.2

[] Empty Array If there are no labels yet, an empty array is returned. 3.2

Example

Iterate all labels, getting the objects associated with them...

enumLabels().forEach( function getObjectFor(labelName) {
	var obj = label(labelName); // retrieve object
	if (obj) {
		// do stuff with object
	} else {
		// there are no objects associated with this label
	}
} );

Availability 3.2+

Requires:

Warzone 3.2 and above.

Scripting: Labels

Related Objects:

Create them:

addLabel() – label an object

List them:

getLabel() – get first label associated with a specific object
enumLabels() – get a list of all labels

Retrieve their objects:

getObject() – get object associated with a label
label() – use this instead on WZ 3.1

Monitor them:

eventArea<Label>() – triggered when a droid enters a labelled Area object
resetArea() – reset or filter an area trigger

Remove them:

removeLabel() – remove a label