ee.List

AI-generated Key Takeaways

• ee.List() constructs a new Earth Engine list object from a JavaScript array or a computed object.

• The list can contain elements of different data types including null, boolean, number, string, and nested lists.

• Both server-side (JavaScript) and client-side (Python) examples are provided to demonstrate the usage and behavior of ee.List().

• The output is a list with the same structure and elements as the input.

Constructs a new list.

Usage	Returns
ee.List(list)	List

Argument	Type	Details
list	List<Object>|Object	A list or a computed object.

Examples

Code Editor (JavaScript)

print(ee.List([]));  // []
print(ee.List([null]));  // [null]
print(ee.List([true]));  // [true]
print(ee.List([1]));  // [1]
print(ee.List([ee.Number(1)]));  // [1]
print(ee.List(['a']));  // ["a"]
print(ee.List([[]]));  // [[]]
print(ee.List([ee.List([])]));  // [[]]
print(ee.List([[], [[]], [1, [], 'a']]));  // [[],[[]],[1,[],"a"]]

Python setup

See the Python Environment page for information on the Python API and using geemap for interactive development.

import ee
import geemap.core as geemap

Colab (Python)

print(ee.List([]).getInfo())  # []
print(ee.List([None]).getInfo())  # [None]
print(ee.List([True]).getInfo())  # [True]
print(ee.List([1]).getInfo())  # [1]
print(ee.List([ee.Number(1)]).getInfo())  # [1]
print(ee.List(['a']).getInfo())  # ['a']
print(ee.List([[]]).getInfo())  # [[]]
print(ee.List([ee.List([])]).getInfo())  # [[]]
print(ee.List([[], [[]], [1, [], 'a']]).getInfo())  # [[], [[]], [1, [], 'a']]