dwds

• Support new DDC temp names for patterns. - #2042
• Make debugger find next dart location when stepping. -#2043

• Fix failure to map JS exceptions to dart. - #2004
• Fix for listening to custom streams. - #2011
• Handle unexpected extension debugger disconnect events without crashing the app - #2021
• Support Set inspection. - #2024

• Cleanup getObject code for lists and maps.
  • Now works with offset 0 and null count.
  • Fix failures on edge cases.
• Support records:
  • Update SDK constraint to >=3.0.0-188.0.dev <4.0.0.
  • Update package:vm_service constraint to >=10.1.2 <12.0.0.
  • Update package:dds constraint to ^2.7.1.
  • Fill BoundField.name for records.
  • Display records as a container of fields.
• Remove test-only code from sdk_configuration.dart.
• Move shared test-only code to a new test_common package.
• Convert unnecessary async code to sync.
• Allow empty scopes in expression evaluation in a frame.

Breaking changes

• Require sdkConfigurationProvider in ExpressionCompilerService constructor.
• Change DWDS parameter isFlutterApp from type bool? to type Future<bool> Function()?.

• Include debug information in the event sent from the injected client to the Dart Debug Extension notifying that the Dart app is ready.
• Fix null cast error on expression evaluations after dwds fails to find class metadata.
• Include the entire exception description up to the stacktrace in mapExceptionStackTrace.
• Allow enabling experiments in the expression compiler service.
• Pre-warm expression compiler cache to speed up Flutter Inspector loading.
• Display full error on failure to start DDS.
• Fix crash on processing DevTools event when starting DevTools from DevTools uri.
• Prepare or Dart 3 alpha breaking changes:
  • Move weak null safety tests to special branch of build_web_compilers.
  • Do not pass --(no)-sound-null-safety flag to build daemon.
• Add back ChromeProxyService.setExceptionPauseMode() without override.
• Make hot restart atomic to prevent races on simultaneous execution.
• Return error on expression evaluation if expression evaluator stopped.
• Update SDK constraint to >=3.0.0-134.0.dev <4.0.0.
• Update package:vm_service constraint to >=10.1.0 <12.0.0.
• Fix expression compiler throwing when weak SDK summary is not found.

Breaking changes

• Include an optional param to Dwds.start to indicate whether it is running internally or externally.
• Include an optional param to Dwds.start to indicate whether it a Flutter app or not.
• Remove sdkConfigurationProvider parameter from Dwds.start.
• Remove deprecated ChromeProxyService.setExceptionPauseMode().
• Support dart 3.0-alpha breaking changes:
  • Generate missing SDK assets for tests.
  • Enable frontend server null safe tests.
  • Update build_web_compilers constraint to ^4.0.0.
  • Update build_runner constraint to ^2.4.0.
  • Support changes in the SDK layout for dart 3.0.

• Allow the following API to return null and add error handling:
  • LoadStrategy.serverPathForModule
  • LoadStrategy.sourceMapPathForModule
• Expression evaluation performance improvement:
  • Batch ChromeProxyService.evaluate() requests that are close in time and are executed in the same library and scope.
• Update package:file version to 6.13 or greater to handle https://github.com/dart-lang/sdk/issues/49647.

• Fix a hang and report errors on hot reload exceptions from the injected client.
• Remove AppInspector.evaluate code that has been replaced by expression evaluation using a compiler in all scenarios.
• Fix a bug where evaluation would fail with more than one parameter in the scope.
• Remove showing un-captured values from the stack during evaluation.
• Refactor code to break most circular dependencies between files.
• Migrate package:dwds to null safety.
• Make ChromeProxyService.getStack wait for the debugger to perform initial resume operation. This avoids race conditions on isolate start.
• Make server paths match directory structure
  • Allows correct relative source map paths resolution.
  • Add PackageUriMapper class to allow mapping uris to server paths.
• Update the min SDK constraint to 2.18.0.
• Make DartUri work for google3: uris.

Breaking changes

• Remove no longer used ExpressionCompilerService.handler.
• Remove assetHandler parameter from ExpressionCompilerService constructor.
• Add packageUriMapper parameter to the constructor of FrontendServerRequireStrategyProvider.

• Port some dwds files to null safety.
• Fix failing frontend_server_evaluate tests.
• Prevent flutter_tools crash when the Dart execution context cannot be found.
• Update method signature of lookupResolvedPackageUris.

• Make data types null safe.
• Update package:vm_service to 8.3.0.
• Convert JavaScript stack traces in uncaught exceptions to Dart stack traces.
• Fix failure to set breakpoints on windows with a base change in index.html.
• Add the setIsolatePauseMode method to Chrome Proxy Service.
• Batch extension Debugger.scriptParsed events and send batches every 1000ms to the server.
• Move batched_stream.dart into shared utilities.
• Update the method signature for lookupResolvedPackageUris.

• Update the min SDK constraint to 2.17.0.

• Add libraryFilters optional parameter to the vm service implementation of getSourceReport.
• Update temp variable detection heuristics so internal JS type objects do not show in the debugger.

• Add column information to breakpoints to allow precise breakpoint placement.
• Split SDK validation methods to allow validation of separate components.
• Remove dependency on package:_fe_analyzer_shared. Note: this removes current incomplete support for resolving dart: uris.
• Fix issues discovered when using flutter tools with web server device:
  • Remove dart:web_sql from the list of SDK libraries as it is no longer used.
  • Fix crash when using flutter tools with web server device.
  • Remove clearing all scripts on page load for extension debugger.
• Fix breakpoints not hitting after changing a base in index.html.
• Find best locations for call frames, breakpoints, or expression evaluation.
• Close the SSE connection when a DebugExtension.detached event is received.
• Fix issues discovered when using legacy module system, debug extension, and JIT modules:
  • Improve step-into times by not stepping into library loading code.
  • Fix incorrect skip lists due to unsorted locations.
  • Fix memory leak in extension debugger by removing stale script IDs.
  • Allow mapping JS locations to Dart locations matching other JS lines, to match the behavior of Chrome DevTools.
  • Fix expression evaluation failure if debugger is stopped in the middle of a variable definition.

Breaking changes:

• Add basePath parameter to FrontendServerRequireStrategy.
• Add loadLibrariesModule getter to LoadStrategy interface.

• Update _fe_analyzer_shared to version ^38.0.0.

• Change wording of paused overlay from "Paused in Dart DevTools" to "Paused"
• Allow sending back the Dart DevTools URL from DWDS instead of launching Dart DevTools, to support embedding Dart DevTools in Chrome DevTools.
• Temporarily disable the paused in debugger overlay.
• Add SdkConfiguration and SdkConfigurationProvider classes to allow for lazily created SDK configurations.
• Fix an issue in reporting DevTools stats where the DevTools load time was not always recorded.
• Add an ide query parameter to the Dart DevTools URL for analytics.
• Fix a race where injected client crashed on events send just before hot restart.
• Remove verbose printing on receiving DevTools events.
• Update vm_service version to ^8.2.0.
• Migrate .packages to package_config.json.
• Update error message on expression evaluation using unloaded libraries.
• Add screen field to the DebuggerReady event.
• Report DebuggerReady events for DevTools embedded into Chrome Devtools.
• Fix missing CallFrame.url after update to Chrome 100.

Breaking changes:

• Dwds.start and ExpressionCompilerService now take sdkConfigurationProvider argument instead of separate SDK-related file paths.

• Update _fe_analyzer_shared to version ^34.0.0.

• Implement lookupResolvedPackageUris and lookupPackageUris vm service API.
• Update vm_service version to ^8.1.0.
• Make ExpressionCompilerService infer location of libraries.json from sdkDir parameter.
• Show an alert in the Dart Debug Extension for a multi-app scenario.
• Fix a bug where dartEmitDebugEvents was set as a String instead of bool in the injected client.
• Emit a warning instead of crashing on missing libraries.json.
• Remove dead code for reading 'dart.developer.registerExtension' and 'dart.developer.postEvent' events from the chrome console. These messages haven't been written to the console since dwds v11.1.0 and Dart SDK v2.14.0.
• Batch debug events sent from injected client to dwds to relieve network load.
• Update _fe_analyzer_shared version to 33.0.0
• Update the Dart minimum SDK to >=2.16.0.

Breaking changes:

• Add sdkDir and librariesPath arguments to Dwds.start to help file resolution for sdk uris.
• Add emitDebugEvents argument to Dwds.start to suppress emitting debug events from the injected client.
• Replace sdkRoot parameter by sdkDir in ExpressionCompilerService.
• Adds an additional parameter to launch Dart DevTools in the same window as the connected Dart app.

• Update SDK constraint to >=2.15.0 <3.0.0.

• Support hot restart in a multi-app scenario with legacy modules.

  • Rename $dartHotRestart in the injected client to $dartHotRestartDwds.
  • Make $dartHotRestartDwds take a runId.
  • No change in behavior for single applications.
  • For a multi-app scenario using legacy modules, this will make all sub-apps with the same runId restart at the same time once.

  Note that multi-app scenario is currently only supported for legacy modules, used by DDR, and is not yet supported for amd modules that are used by flutter tools and webdev.

• Fix chrome detection in iPhone emulation mode in chrome or edge browsers.

• Reliably find unused port for extension backend http service.

• Ignore offset / count parameters in getObject if the object has no length.

• Include static member information for classes.

• Fix duplicated scripts returned by VmService.getScripts API.
• Handle and log http request serving errors.
• Encode extension url asynchronously.
• Use default constant port for debug service.
  • If we fail binding to the port, fall back to previous strategy of finding unbound ports.
• Add metrics measuring
  • DevTools Initial Page Load time
  • Various VM API
  • Hot restart
  • Http request handling exceptions
• Only return scripts included in the library with Library object.
• Add ext.dwds.sendEvent service extension to dwds so other tools can send events to the debugger. Event format:

  {
    'type': '<event type>',
    'payload': {
      'screen: '<screen name>',
      'action: '<action name>'
    }
  }
  

  Currently supported event values:

  {
    'type: 'DevtoolsEvent',
    'payload': {
      'screen': 'debugger',
      'action': 'pageReady'
    }
  }
  

• Update SDK constraint to >=2.14.0 <3.0.0
• Depend on vm_service version 7.3.0.

• Fix race causing intermittent Aww, snap errors on starting debugger with multiple breakpoints in source.
• Fix needing chrome to be focus in order to wait for the isolate to exit on hot restart.

• Depend on dds version 2.1.1.
• Depend on vm_service version 7.2.0.

• Recover from used port errors when starting debug service.
• Update min SDK constraint to 2.13.0.

• Throw SentinelException instead of RPCError on vm service API on unrecognized isolate.
• Throw RPCError in getStack if the application is not paused.
• Recognize dart:ui library when debugging flutter apps.
• Fix hang on hot restart when the application has a breakpoint.
• Fix out of memory issue during sending debug event notifications.

• Return empty library from ChromeProxyService.getObject for libraries present in metadata but not loaded at runtime.
• Log failures to load kernel during expression evaluation.
• Show lowered final fields using their original dart names.
• Limit simultaneous connections to asset server to prevent broken sockets.
• Fix hangs in hot restart.
• Initial support for passing scope to ChromeProxyService.evaluate.
• Require build_web_compilers version 3.0.0 so current version of dwds could be used with SDK stable 2.13.x versions.

• Update versions of package:sse, package:vm_service, package:dds.

• Implement _flutter.listViews extension method in dwds vm client.

• Make adding and removing breakpoints match VM behavior:
  • Allow adding existing breakpoints.
  • Throw RPCError when removing non-existent breakpoints.

• Do not send kServiceExtensionAdded events to subscribers on the terminating isolate during hot restart.
• Support vm_service version 6.2.0.
• Fix missing sdk libraries in getObject() calls.
• Fix incorrect rootLib returned by ChromeProxyService.
• Fix not working breakpoints in library part files.
• Fix data race in calculating locations for a module.
• Fix uninitialized isolate after hot restart.
• Fix intermittent failure caused by evaluation not waiting for dependencies to be updated.
• The injected client now posts a top level event when the Dart application is loaded. This event is intended to be consumed by the Dart Debug Extension.

Breaking changes:

• Dwds.start no longer supports automatically injecting a devtools server. A devtoolsLauncher callback must be provided to support launching devtools.

• Support webkit_inspection_protocol version ^1.0.0.

• Support VMService.evaluate using expression compiler.
• Update min sdk constraint to >=2.13.0-144.0.dev.
• Throw RPCError on evaluation if the program is not paused.
• Record ErrorRef returned by evaluation in analytics.

Breaking changes:

• Change ExpressionCompiler.initialize method to include module format.
• Add LoadStrategy.moduleFormat to be used for communicating current module format to the expression compiler.

• Support authentication endpoint for the Dart Debug Extension.
• Support using WebSockets for the injected client by passing useSseForInjectedClient: false to Dwds.start(). Unlike SSE, WebSockets do not currently support keepAlives here (beyond the standard WebSocket pings to keep the socket alive).

• Fix an issue where relative worker paths provided to the ExpressionCompilerService would cause a crash.
• Fix an issue where the injected client connection could be lost while the application is paused.
• Support keep-alive for debug service connections.
• Depend on the latest package:sse.
• Filter out DDC temporary variables from the variable inspection view.
• Add DwdsEvents around stepping and evaluation.
• Send an event to the Dart Debug Extension that contains VM service protocol URI.
• Depend on package:vm_service version 6.1.0+1.
• Update the keepAlive configs to prevent accidental reuse of a connection after stopping a debug session.
• Support disabling the launching of Dart DevTools through Alt + d with enableDevtoolsLaunch.
• Opt all dart files out of null safety for min SDK constraint update.

Breaking changes:

• LoadStrategys now require a moduleInfoForEntrypoint.

• Fix an issue where failed hot restarts would hang indefinitely.

• Change ExpressionCompiler to accept FutureOr<int> port configuration.
• Depend on package:vm_service version 6.0.1-nullsafety.1.

• Support null safe versions of package:crypto, package:uuid and package:webdriver.

• Improve logging around execution contexts.
• Remove the expression compilation dependency update from the create isolate critical path.
• Expose new event stream for future use with analytics.
• Update ExpressionCompiler to include new initialize method which has a parameter for the null safety mode.
• Update ExpressionCompilerService to change how it is instantiated and implement the new initialize method.
• Provide summary module paths to the expression compiler
• Depend on package:vm_service version 6.0.1-nullsafety.0.

Breaking changes:

• Change ExpressionCompiler.updateDependencies method to include module summary paths

• Properly handle requireJS errors during hot restarts.
• Fix an issue where Dart frame computation could result in a stack overflow for highly nested calls.
• Fix an issue where calling add breakpoint in quick succession would corrupt the internal state.
• Fix expression evaluation failure inside blocks.
• Now log the encoded URI of the debug service to both the terminal and application console.
• No longer blacklist the Dart SDK as the skipLists support serves the same purpose.
• Fix an issue where running webdev with expression evaluation enabled would fail to find libraries.json file and emit severe error.

• Fix a potential null issue while resuming.
• Depend on the latest package:vm_service.
• Fix crash in expression evaluation on null isolate.
• Fix incorrect file name detection for full kernel files.
• Add ExpressionCompilerService.startWithPlatform API to enable running expression compiler worker from a given location.
• Support Chrome skipLists to improve stepping performance.
• Export AbsoluteImportUriException.
• Depend on the latest package:vm_service which supports a new limit parameter to getStack.

• Depend on the latest package:sse.
• Add more verbose logging around hotRestart, fullReload and entrypoint injection.

• Add support for the Dart Development Service (DDS). Introduces 'single client mode', which prevents additional direct connections to DWDS when DDS is connected.
• Update metadata reader version to 2.0.0. Support reading metadata versions 2.0.0 and 1.0.0.
• Support custom hosts and HTTPs traffic in a ProxyServerAssetReader.
• Remove heuristics from require strategies and use metadata to look up module paths.
  • Fix issue where upgrading build_web_compilers would cause missing module assets (JavaScript code and source maps).
• Fix issue where open http connections prevent the process for exiting.
• Add ExpressionCompilationService class that runs ddc in worker mode to support expression evaluation for clients that use build systems to build the code.
• Require at least devtools and devtools_server version 0.9.2.
• Require at least dds version 1.4.1.
• Require at least build_web_compilers version 2.12.0.
• Update min sdk constraint to >=2.10.0.
• Update MetadataProvider to throw an AbsoluteImportUriException when absolute file paths are used in an import uri.

Breaking changes:

• Change ExpressionCompiler to require a new updateDependencies method.
• Update a number of LoadStrategy APIs to remove heuristics and rely on the MetadataProvider.
• No longer require a LogWriter and corresponding verbose argument but instead properly use package:logger.
• FrontendServerRequireStrategyProvider now requires a digestProvider.

• Depend on the latest package:devtools and package:devtools_server.
• Support using WebSockets for the debug backend by passing useSseForDebugBackend: false to Dwds.start()
• Ensure we run main on a hot restart request even if no modules were updated.
• Allow reading metadata generated by dev_compiler from file to supply module information to Dwds.
• Hide JavaScript type errors when hovering over text in the debugger.
• Fix an issue where reusing a connection could cause a null error.
• Improve the heuristic which filters JS scopes for debugging needs.

Breaking Changes:

• Require access to the .ddc_merged_metadata file.
• Remove deprecated parameter restoreBreakpoints as breakpoints are now set by regex URL and Chrome automatically reestablishes them.

• Have unimplemented VM service protocol methods return the RPC error 'MethodNotFound' / -32601.
• Fix an issue where the application main function was called before a hot restart completed.
• Breaking change AssetReader now requires a metadataContents implementation.

• Fixed issue where getSupportedProtocols would return the wrong protocol.

• Pin the package:vm_service version to prevent unintended breaks.

• Fix an issue where the injected client served under https assumed the corresponding SSE handler was also under https.

• Gracefully handle multiple injected clients on a single page.
• Update to the latest package:vm_service and use more RPCError error codes on call failures.
• Update the require_restarter to rerun main after a hot restart to align with the legacy strategy. We therefore no longer send a RunRequest after a hot restart.
• Compute only the required top frame for a paused event.
• Change streamListen to return an RPCError / error code -32601 for streams that are not handled.
• Populate information about async Dart frames.
• Populate the exception field in debugger pause event when we break as a result of an exception.
• Prompt users to install the Dart Debug Extension if local debugging does not work.
• Allow for the injected client to run with CSP enforced.
• Implement the getMemoryUsage() call.
• Fix an issue where the injected client could cause a mixed content error.

• Change the reported names for isolates to be more terse.
• Implemented the 'PossibleBreakpoints' report kind for getSourceReport().
• Change the returned errors for the unimplemented getClassList and reloadSources methods to -32601 ('method does not exist / is not available').
• Do not include native JavaScript objects on stack returned from the debugger.

• Support Chromium based Edge.
• Depend on latest package:sse version 3.5.0.
• Bypass connection keep-alives when shutting down to avoid delaying process shutdown.
• Fix an issue where the isolate would incorrectly be destroyed after connection reuse.

• Support the latest version of package:shelf_packages_handler.
• Throw a more useful error if during a hot restart there is no active isolate.
• Fix a race condition in which loading module metadata could cause a crash.
• Correct scope detection for expression evaluation
• Silence verbose and recoverable exceptions during expression evaluation
• Return errors from ChromeProxyService.evaluateInFrame as ErrorRef so they are not shown when hovering over source in the IDE

• Fix an issue in JS to Dart location translation in ExpressionEvaluator. JS location returned from Chrome is 0-based, adjusted to 1-based.

• Drop dependency on package_resolver and use package_config instead.
• Bump min sdk constraint to >=2.7.0.

• Depend on the latest package:vm_service version 4.0.0.

Breaking Changes:

• Delegate to the LoadStrategy for module information:
  • moduleId -> serverPath
  • serverPath -> moduleId