Clarify lifetime of DataBreakpoint.dataId

microsoft · Jun 7, 2023 · 3a747cd · 3a747cd
1 parent 76addb3
commit 3a747cd
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 1 deletion.
diff --git a/changelog.md b/changelog.md
@@ -6,6 +6,9 @@ sectionid: changelog
 
 #### All notable changes to the specification will be documented in this file.
 
+* 1.62.x
+  * Clarify lifetime of `DataBreakpoint.dataId`
+
 * 1.61.x
   * Removed unused `ModulesViewDescriptor` interface
   * Clarify the applicability of `supportsVariablePaging`

diff --git a/debugAdapterProtocol.json b/debugAdapterProtocol.json
@@ -1477,7 +1477,7 @@
 						"properties": {
 							"dataId": {
 								"type": [ "string", "null" ],
-								"description": "An identifier for the data on which a data breakpoint can be registered with the `setDataBreakpoints` request or null if no data breakpoint is available."
+								"description": "An identifier for the data on which a data breakpoint can be registered with the `setDataBreakpoints` request or null if no data breakpoint is available. If a `variablesReference` or `frameId` is passed, the `dataId` is valid in the current suspended state, otherwise it's valid indefinitely. See 'Lifetime of Object References' in the Overview section for details. Breakpoints set using the `dataId` in the `setDataBreakpoints` request may outlive the lifetime of the associated `dataId`."
 							},
 							"description": {
 								"type": "string",