This is an automated email from the ASF dual-hosted git repository. Cole-Greer pushed a commit to branch GValueFollowupTP4 in repository https://gitbox.apache.org/repos/asf/tinkerpop.git
commit 0f701840e1358f013a35a6b968deac8462db609a Author: Cole Greer <[email protected]> AuthorDate: Wed Jun 10 16:58:59 2026 -0700 Document GValue name validation change and JavaScript GValue support Adds a CHANGELOG entry for relaxing GValue name validation (removal of the reserved leading-underscore restriction) and replaces the stale 'not yet implemented' JavaScript GValue reference section with real usage now that the JavaScript GLV supports GValue. Assisted-by: Kiro:claude-opus-4.8 --- CHANGELOG.asciidoc | 1 + docs/src/reference/gremlin-variants.asciidoc | 13 +++++++++++-- 2 files changed, 12 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc index e312807286..98fead24ea 100644 --- a/CHANGELOG.asciidoc +++ b/CHANGELOG.asciidoc @@ -53,6 +53,7 @@ image::https://raw.githubusercontent.com/apache/tinkerpop/master/docs/static/ima * Modified HTTP API to expect gremlin-lang strings for parameters and update all GLVs to send requests in new format. * Added string parameter parsing to `GremlinServer` to prevent traversal injection and excessive nesting depths. * Modified all GLVs to detect unsupported types in `GremlinLang` and throw consistent error for that case. +* Relaxed `GValue` name validation by removing the reserved leading underscore restriction. [[release-4-0-0-beta-2]] === TinkerPop 4.0.0-beta.2 (April 1, 2026) diff --git a/docs/src/reference/gremlin-variants.asciidoc b/docs/src/reference/gremlin-variants.asciidoc index 21a833b04f..b6c5dce9f2 100644 --- a/docs/src/reference/gremlin-variants.asciidoc +++ b/docs/src/reference/gremlin-variants.asciidoc @@ -1784,8 +1784,17 @@ Promise.all([ [[gremlin-javascript-gvalue]] === GValue Parameterization -IMPORTANT: 4.0.0-beta.2 Release - `GValue` parameterization is not yet implemented for the JavaScript driver. This -functionality is planned for a future release. +A `GValue` is an encapsulation of a parameter name and value. A <<traversal-parameterization,subset of gremlin steps>> +are able to accept GValues. When constructing a `GraphTraversal` with such steps in JavaScript, a GValue may be passed +in the traversal to utilize a parameter in place of a literal. + +[source,javascript] +---- +const GValue = gremlin.process.GValue; + +g.V().has('name', new GValue('name', 'marko')); +g.mergeV(new GValue('vertexPattern', { name: 'marko' })); +---- [[gremlin-javascript-scripts]] === Submitting Scripts
