This is an automated email from the ASF dual-hosted git repository.
spmallette pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/tinkerpop.git
The following commit(s) were added to refs/heads/master by this push:
new ddb44ef25d docs: note format() silent-drop on missing property
ddb44ef25d is described below
commit ddb44ef25d6eaad5e95d6183f7c302082472c4a6
Author: Stephen Mallette <[email protected]>
AuthorDate: Mon Jul 20 20:13:55 2026 +0000
docs: note format() silent-drop on missing property
Assisted-by: Kiro:claude-sonnet-4-20250514
---
docs/src/reference/the-traversal.asciidoc | 2 ++
1 file changed, 2 insertions(+)
diff --git a/docs/src/reference/the-traversal.asciidoc
b/docs/src/reference/the-traversal.asciidoc
index 042c47ce7e..1915d9f62c 100644
--- a/docs/src/reference/the-traversal.asciidoc
+++ b/docs/src/reference/the-traversal.asciidoc
@@ -2149,6 +2149,8 @@
g.V().project("name","count").by(values("name")).by(bothE().count()).format("%{n
<3> A `format()` will use property `name` and traversal product for positional
argument to resolve variable values.
<4> A `format()` will use map produced by `project` step to resolve variable
values.
+NOTE: If a `%{key}` placeholder references a property that does not exist on
the incoming element, that traverser is silently dropped from the result.
+
*Additional References*
link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#format(java.lang.String)++[`format(String)`],
