Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.String.aside
Stay organized with collections
Save and categorize content based on your preferences.
Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:
var c = ee.ImageCollection('foo').aside(print)
.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')
.filterBounds(geom).aside(print, 'In region')
.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')
.select('a', 'b');
Returns the same object, for chaining.
Usage | Returns | String.aside(func, var_args) | ComputedObject |
Argument | Type | Details | this: computedobject | ComputedObject | The ComputedObject instance. |
func | Function | The function to call. |
var_args | VarArgs<Object> | Any extra arguments to pass to the function. |
Examples
Code Editor (JavaScript)
// aside with no var_args.
// a
ee.String('a').aside(print);
// foo
// bar
ee.String('foo').aside(print, 'bar');
// foo
// bar
//
// foo
print(ee.String('foo').aside(print, 'bar'));
// aside in the middle of a chain of calls.
// a
// b
//
// ac
print(ee.String('a').aside(print, 'b').cat('c'));
// aside with more than one var_args.
// a
// 1
// 2
ee.String('a').aside(print, 1, 2);
// Print a empty JSON string.
// ''
ee.String('').aside(print);
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)
def print_result(val, *params):
"""A print function to invoke with the aside method."""
print(val.getInfo())
for param in params:
print(param)
# aside with no var_args.
# a
ee.String('a').aside(print_result)
# foo
# bar
ee.String('foo').aside(print_result, 'bar')
# foo
# bar
#
# foo
print(ee.String('foo').aside(print_result, 'bar').getInfo())
# aside in the middle of a chain of calls.
# a
# b
#
# ac
print(ee.String('a').aside(print_result, 'b').cat('c').getInfo())
# aside with more than one var_args.
# a
# 1
# 2
ee.String('a').aside(print_result, 1, 2)
# Print a empty JSON string.
# ''
ee.String('').aside(print_result)
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-08 UTC.
[null,null,["Last updated 2025-07-08 UTC."],[[["\u003cp\u003eThe \u003ccode\u003easide()\u003c/code\u003e function allows calling a specified function with the current object as the first argument without altering the object itself, enabling debugging and side-effect operations within a processing chain.\u003c/p\u003e\n"],["\u003cp\u003eIt returns the original object, making it suitable for chaining with other Earth Engine operations.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003easide()\u003c/code\u003e accepts a function and optional additional arguments, which are passed to the function alongside the object.\u003c/p\u003e\n"],["\u003cp\u003eThis functionality is useful for printing intermediate results, displaying data on a map, or performing other actions without interrupting the workflow.\u003c/p\u003e\n"],["\u003cp\u003eExamples in JavaScript and Python demonstrate how \u003ccode\u003easide()\u003c/code\u003e can be integrated into Earth Engine scripts for various purposes.\u003c/p\u003e\n"]]],["The `aside` function calls a specified function (`func`) using the current object as the first argument, along with any additional arguments (`var_args`). It then returns the original object, enabling method chaining. This is useful for debugging and inspecting intermediate steps. The function accepts a `ComputedObject`, a function, and optional arguments. It's demonstrated in both JavaScript and Python, with examples showcasing usage with and without `var_args`, and in the middle of a call chain.\n"],null,["# ee.String.aside\n\n\u003cbr /\u003e\n\nCalls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:\n\n\u003cbr /\u003e\n\nvar c = ee.ImageCollection('foo').aside(print)\n\n.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')\n\n.filterBounds(geom).aside(print, 'In region')\n\n.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')\n\n.select('a', 'b');\n\nReturns the same object, for chaining.\n\n| Usage | Returns |\n|--------------------------------|----------------|\n| String.aside`(func, var_args)` | ComputedObject |\n\n| Argument | Type | Details |\n|------------------------|-------------------|----------------------------------------------|\n| this: `computedobject` | ComputedObject | The ComputedObject instance. |\n| `func` | Function | The function to call. |\n| `var_args` | VarArgs\\\u003cObject\\\u003e | Any extra arguments to pass to the function. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// aside with no var_args.\n// a\nee.String('a').aside(print);\n\n// foo\n// bar\nee.String('foo').aside(print, 'bar');\n\n// foo\n// bar\n//\n// foo\nprint(ee.String('foo').aside(print, 'bar'));\n\n// aside in the middle of a chain of calls.\n// a\n// b\n//\n// ac\nprint(ee.String('a').aside(print, 'b').cat('c'));\n\n// aside with more than one var_args.\n// a\n// 1\n// 2\nee.String('a').aside(print, 1, 2);\n\n// Print a empty JSON string.\n// ''\nee.String('').aside(print);\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\ndef print_result(val, *params):\n \"\"\"A print function to invoke with the aside method.\"\"\"\n print(val.getInfo())\n for param in params:\n print(param)\n\n\n# aside with no var_args.\n# a\nee.String('a').aside(print_result)\n\n# foo\n# bar\nee.String('foo').aside(print_result, 'bar')\n\n# foo\n# bar\n#\n# foo\nprint(ee.String('foo').aside(print_result, 'bar').getInfo())\n\n# aside in the middle of a chain of calls.\n# a\n# b\n#\n# ac\nprint(ee.String('a').aside(print_result, 'b').cat('c').getInfo())\n\n# aside with more than one var_args.\n# a\n# 1\n# 2\nee.String('a').aside(print_result, 1, 2)\n\n# Print a empty JSON string.\n# ''\nee.String('').aside(print_result)\n```"]]