diff --git a/doc/api/v8.md b/doc/api/v8.md index e0b2039264b63b..4f72b16e017913 100644 --- a/doc/api/v8.md +++ b/doc/api/v8.md @@ -18,11 +18,20 @@ added: v8.0.0 * Returns: {integer} -Returns an integer representing a "version tag" derived from the V8 version, -command-line flags and detected CPU features. This is useful for determining +Returns an integer representing a version tag derived from the V8 version, +command-line flags, and detected CPU features. This is useful for determining whether a [`vm.Script`][] `cachedData` buffer is compatible with this instance of V8. +```js +console.log(v8.cachedDataVersionTag()); // 3947234607 +// The value returned by v8.cachedDataVersionTag() is derived from the V8 +// version, command-line flags, and detected CPU features. Test that the value +// does indeed update when flags are toggled. +v8.setFlagsFromString('--allow_natives_syntax'); +console.log(v8.cachedDataVersionTag()); // 183726201 +``` + ## `v8.getHeapSpaceStatistics()`