w_transport

Info

Build: (waiting for build to complete)
Skynet Results: (waiting for Skynet results)
Pipeline: (waiting for pipeline to start)
This patch release includes the following changes:

Miscellaneous

• #456 Raise the mime dependency min to 1.0.0 and max to 3.0.0

• #457 RM-383407 Release w_transport 5.4.4

  • RM-383407 RELEASE w_transport 5.4.4

Notes created on Thursday, April 30 07:31 PM UTC

Info

Build: (waiting for build to complete)
Skynet Results: (waiting for Skynet results)
Pipeline: (waiting for pipeline to start)
This patch release includes the following changes:

Miscellaneous

• #453 Update SDK range in example

• #454 RM-382694 Release w_transport 5.4.3

  • RM-382694 RELEASE w_transport 5.4.3

Notes created on Tuesday, February 24 07:38 PM UTC

• Updated SDK ranges in the example package to keep it aligned with current tooling.

Info

Build: (waiting for build to complete)
Skynet Results: (waiting for Skynet results)
Pipeline: (waiting for pipeline to start)
This patch release includes the following changes:

Miscellaneous

• #451 2_raise_build_deps_max_for_analyzer_10

• #452 RM-351805 Release w_transport 5.4.2

  • RM-351805 RELEASE w_transport 5.4.2

Notes created on Sunday, February 22 07:54 PM UTC

• Raised build dependency ranges to support newer analyzer versions under Dart 3.

Info

Build: (waiting for build to complete)
Skynet Results: (waiting for Skynet results)
Pipeline: (waiting for pipeline to start)
This patch release includes the following changes:

Bug Fixes

• #449 FEA-8530: Fix late init error
  • FEA-8530 Late init error in w_transport

Miscellaneous

• #450 RM-349935 Release w_transport 5.4.1
  • RM-349935 RELEASE w_transport 5.4.1

Notes created on Tuesday, August 26 08:02 PM UTC

• Removed possibility for a LateInitializationError when transforming a ProgressEvent stream from an HttpRequest into a RequestProgress stream.

Info

Build: (waiting for build to complete)
Skynet Results: (waiting for Skynet results)
Pipeline: (waiting for pipeline to start)
This minor release includes the following changes:

Miscellaneous

• #445 Rollout React 18 to tests and example apps

• #446 FEA-8447: Add BinaryRequest for sending requests and reading responses as ArrayBuffers in the browser

  • FEA-8447 Add BinaryRequest for sending requests and reading responses as ArrayBuffers in the browser

• #447 FEDX-3766: no_entrypoint_imports

  • FEDX-3766 no_entrypoint_imports

• #448 RM-343161 Release w_transport 5.4.0

  • RM-343161 RELEASE w_transport 5.4.0

Notes created on Monday, August 18 05:29 PM UTC

• Added BinaryRequest for sending raw bytes with proper browser support using the responseType field on the XHR instance.

Info

Build: (waiting for build to complete)
Skynet Results: (waiting for Skynet results)
Pipeline: (waiting for pipeline to start)
This minor release includes the following changes:

Miscellaneous

• #437 Prep for auto-publish

• #438 Raise the uuid dependency max to v5.0.0

• #439 Raise the uuid dependency min to v4.0.0

• #443 FEA-8162: Support setting Websocket.binaryType

  • FEA-8162 Support setting Websocket.binaryType

• #444 RM-304477 Release w_transport 5.3.0

  • RM-304477 RELEASE w_transport 5.3.0

Notes created on Wednesday, July 16 09:42 PM UTC

• Added WebSocket.binaryType field to allow configuring the binary type for WebSocket connections in the browser. Has no impact on the VM or when using SockJS.

Info

Build: (waiting for build to complete)
Skynet Results: (waiting for Skynet results)
Pipeline: (waiting for pipeline to start)
This patch release includes the following changes:

Miscellaneous

• #434 ESG-11074 Don't log bytes / body in the error message
  • ESG-11074 w_transport: Don't log bytes / body in the error message
• #436 RM-302024 Release w_transport 5.2.3
  • RM-302024 RELEASE w_transport 5.2.3

Notes created on Tuesday, December 17 08:32 PM UTC

Info

Build: (waiting for build to complete)
Skynet Results: (waiting for Skynet results)
Pipeline: (waiting for pipeline to start)
This patch release includes the following changes:

Miscellaneous

• #425 DSC-10121 - Complete transition to GHA

  • DSC-10121 GHA - OpenSource - w_transport

• #427 Replace mockito with mocktail

• #428 Workiva Analysis Options v2

• #429 Raise the build_web_compilers dependency max to v5.0.0

• #430 Raise the meta dependency min to v1.16.0

• #432 raise_min_dart_sdk_2_19

• #433 RM-251053 Release w_transport 5.2.2

  • RM-251053 RELEASE w_transport 5.2.2

Notes created on Saturday, December 07 12:24 AM UTC

Info

Build: https://ci.webfilings.com/build/5728165
Skynet Results: https://wf-skynet-hrd.appspot.com/apps/test/smithy/5728165/latest
Pipeline: No Pipeline
This patch release includes the following changes:

Miscellaneous

• #421 FEA-3269: Fixed CI and addressed NNBD errors

  • FEA-3269 Fixed CI and addressed NNBD errors

• #422 Allow consumption of null-safe over_react and over_react_test versions

• #423 Consume null-safe over_react v5 and over_react_test v3

• #424 RM-222341 Release w_transport 5.2.1

  • RM-222341 RELEASE w_transport 5.2.1

Notes created on Friday, March 29 11:13 PM UTC

Info

Build: https://ci.webfilings.com/build/5155449
Skynet Results: https://wf-skynet-hrd.appspot.com/apps/test/smithy/5155449/latest
Pipeline: No Pipeline
This minor release includes the following changes:

Miscellaneous

• #417 RM-222302 Release w_transport 5.2.0
  • RM-222302 RELEASE w_transport 5.2.0

Notes created on Friday, November 03 08:51 PM UTC

• Added debugUrl to WebSocketConnectEvent which is emitted via the GlobalWebSocketMonitor. When using SockJS, this will be populated with the full URL that the underlying transport is using, which can be useful information for debugging.

• Added defaultTimeoutThreshold top level field to add a timeout for all requests by default.

• Made RequestException.request nullable and re-add the null check, as we found unsound consumer usages where this could be null.
• Bumped collection dependency to a non-pre-release version.

• Updated to null safety:
  • Made as much of the public API non-nullable as safely possible.
  • One notable behavioral change that was required in order to make the request dispatch methods (like .get() and .post()) return non-nullable: if any response interceptor takes a non-null response but returns a null response, the original non-null response will be used instead. In practice, we don't think this is common, and being able to make request methods return non-nullable was worth it.

• Bug Fix: When using MockTransports.install(fallThrough: true), the optional body param on the send() method will now properly be applied when the request "falls through" the mock config to a real request.
• Docs: Suggest using .streamGet() over .get() for binary responses that will be read as bytes (via body.asBytes()).

• Widen ranges on fluri and http_parser

• Improvement JSON content will always decode as utf-8. Previously it would fall back to the encoding specified for the body, or to ISO-8859-1, which was the old fallback value. There is no longer any fallback value, per rfc7231, but it uses the media type value, which for JSON is by default UTF-8.

• Improvement: AutoRetryConfig gained the increaseTimeoutOnRetry flag. This allows timeouts to increase as retry attempts increase.

• Update the changelog

• Bug Fix: The body parameter given to Request.send() was being ignored. It should now be used as expected.

• Improvement: Implement equality for RegExp to ensure 2 mock request handlers with the same pattern and regex settings are stored in a common map.

This is a major release with breaking changes.

Previously, this project included a sockjs_client dependency via a git reference, but in July of 2019 pub.dev began disallowing the publishing of packages with git dependencies. Additionally, this package included public APIs that depended on this git dependency. We are unable to get this dependency moved to pub.dev, so our only option is to release a major version and remove our usage of this dependency and any relevant APIs.

We also had some pre-existing deprecations that we are removing in this major release.

With only a couple of exceptions, this 4.0.0 version should be backwards- compatible with 3.x.x as long as uses of deprecated APIs have been resolved.

Breaking Changes

• Breaking: Consumers of the SockJS implementation behind WebSocket must now include sockjs.js on the page:
  • SockJS usage
• Breaking: Removed the following deprecated APIs:
  • The WSocket class. Use WebSocket instead.
  • WSocketCloseEvent
  • WSocketException
  • The SockJS optional parameters (e.g. useSockJS or sockJSProtocolsWhitelist) for:
    • configureWTransportForBrowser()
    • WebSocket.connect()

Additional Changes

• Improvement: Be robust to empty contentType header on response.
• Improvement: The jitter approach used previously for exponential backoffs still leads to peaks in server load. This is now improved by adopting a more advanced backoff algorithm from Polly.
• Improvement: Added closeCode and closeReason getters to MockWebSocketServer.
• Improvement: prep for a breaking change in Dart SDK to HttpRequest and HttpClientResponse
• Tech-debt: upgrade to dart_dev v3
• Tech-debt: use workiva_analysis_options to simplify linter/analysis configuration.
• Tech-debt: remove Dart 1 support

• Tech-debt: upgrade to dart_dev v2

October 10th, 2018

• Improvement: Dart 2 compatible!

July 19th, 2018

• Bug Fix: When using MockTransports with fallThrough: true, requests that fall through now properly copy over contentLength and contentType if applicable.

• Dependency: Upgraded minimum sockjs_client_wrapper version to 1.0.4 in order to pull in SockJS v1.1.5.

May 17th, 2018

• Bug Fix: The previous version introduced a new transformer for the w_transport examples, but did not properly scope it to the examples/ directory. This led to the following error during a pub get for some consumers:

  Precompiling dependencies...
  Loading source assets...
  Error on line 1, column 1 of https://pub.dartlang.org/api/packages/w_transport: Error loading transformer "over_react": package "over_react" is not a dependency.
  

  This has been fixed. If you're still seeing this error, run pub upgrade w_transport to make sure you have the latest.

May 16th, 2018

• Bug Fix: The browser implementation of MultipartRequest was previously adding every field to the FormData twice - this has been fixed.

April 25th, 2018

• Improvement: Now compatible with Dart 2 and the Dart Dev Compiler.

April 20th, 2018

• Documentation: Fixed some broken links.

January 29th, 2018

• Bug Fix: The sockjs.js detection now uses context.hasProperty() instead of actually trying to access the SockJS object on the window. This fixes an exception that was being thrown silently in certain situations.

January 4th, 2018

• Improvement: Added support for the sockjs_client_wrapper package. This will eventually replace our usage of the sockjs_client Dart port because the wrapper uses the actual JS library which is fully-featured and community supported.

  The SockJS wrapper requires that the JS library be included in the HTML page. To avoid a breaking change, it will only be used if the JS library is detected on the window.

  If you are using the SockJS configuration for WebSocket and wish to leverage this more fully-featured SockJS (which provides all of the SockJS protocols e.g. xhr-polling), all you need to do is add the JS script to your application page:

  https://github.com/workiva/sockjs_client_wrapper#usage

  If you don't change anything, the SockJS configuration for WebSocket will still behave exactly the same and you should see no difference.

March 15th, 2017

• Bug Fix: When a request is canceled, it will now always result in the done Future resolving. Previously it was possible for the done Future to never resolve if the request was canceled at a certain point during the request lifecycle.

February 3rd, 2017

• Bug Fix: When MockTransports is installed with "fall-through" enabled, the optional SockJS params that are available on the new transport.WebSocket() constructor are now properly passed through. Previously, a standard WebSocket implementation would have been constructed erroneously if useSockJS: true was set, but it now correctly constructs the SockJS implementation.

January 18th, 2017

• Bug Fix: If a request's autoRetry.test function is supplied and returns true when the response is null, a request that was canceled would erroneously be retried. Canceling a request now properly makes it ineligible for retry regardless of other factors.

October 25th, 2016

This major release includes deprecations and an increased minimum Dart SDK version. This release should be backwards compatible with version 2.x.

To upgrade, check out the v3.0.0 upgrade guide.

Features

• There is a new pattern for configuring w_transport for a particular platform. Check out the Transport Platform Configuration guide.

• There is a new way to install the transport mocks (instead of configureWTransportForTest()). Check out the Mock Transports Installation guide.

Changes/Deprecations

• Renamed entry points:

  • w_transport_browser.dart --> browser.dart
  • w_transport_mock.dart --> mock.dart
  • w_transport_vm.dart --> vm.dart

• Other renames:

  • Client --> HttpClient
  • WSocket --> WebSocket
  • WSocketException --> WebSocketException
  • RetryBackOff.duration --> RetryBackOff.interval

• Other deprecations:

  • WSocketCloseEvent
  • MockBaseRequest
  • MockClient
  • MockFormRequest
  • MockJsonRequest
  • MockPlainTextRequest
  • MockResponse
  • MockStreamedRequest
  • MockStreamedResponse
  • MockWSocket

Documentation

• The w_transport documentation has been revamped with an emphasis on examples and guides. Check them out now!

October 14, 2016

• Bug Fix: The Future returned from WSocket.cancel() no longer waits for the WebSocket to be closed.

September 8, 2016

• Bug Fix: if a request is canceled right before it would also have exceeded the timeout threshold, a StateError may be thrown due to a Completer being completed more than once. This is fixed now.

August 11, 2016

• Widen the version range for the http_parser dependency to speed up and/or fix downstream consumers experiencing version conflicts.

August 2, 2016

• Bug Fix: previously, listening to a WSocket instance and then canceling the subscription before closing the socket would result in the "done" state never being reached. This is fixed now and the Future returned from WSocket.done and WSocket.close() will always resolve once the connection is closed.

July 26, 2016

• Improvement: All request classes now have a bool isDone getter that can be read to determine whether or not a request is complete (i.e. succeeded, failed, or canceled).

• Bug Fix: Calling request.abort() more than once will no longer throw a StateError.

July 21, 2016

• Improvement: Mock transport handlers can now be canceled. This will allow consumers to remove HTTP or WebSocket mock handlers without having to call MockTransports.reset() or MockTransports.uninstall.

  var uri = Uri.parse('/example');
  
  var myHttpHandler = MockTransports.http.when(uri, (request) { ... });
  myHttpHandler.cancel();
  
  var myWebSocketHandler = MockTransports.webSocket.when(uri,
      handler: (protocols, headers) { ... });
  myWebSocketHandler.cancel();
  
  /// The same works for the `whenPattern()` methods, as well.
  

July 20, 2016

• Bug Fix: previously, you could not retry a request that failed with a null response. This is now allowed, but still has the same default behavior. To retry a request with a null response, use the autoRetry.test method accordingly:

  var request = new Request();
  request.autoRetry
    ..enabled = true
    ..test = (request, response, willRetry) {
      if (response == null) return true;
      return willRetry;
    };
  

June 23, 2016

• Deprecation: autoRetry.backOff.duration has been deprecated in favor of the more aptly named autoRetry.backOff.interval.

• Improvement: Automatic request retrying will now add jitter to the backoff intervals by default. To disable jitter, set autoRetry.backOff.withJitter = false;.

• Improvement: You can now put a cap on the backoff interval used during automatic request retrying.

  request.autoRetry.backOff.maxInterval = new Duration(minutes: 2);
  

• Bug Fix: A request's encoding property can no longer be set to null. This would have most likely caused an RTE when the request was sent, so now an ArgumentError will be thrown immediately.

• Bug Fix: As of 2.6.0, if you were to set a request's content-type manually without a charset or with an unknown charset, it was possible to hit an RTE due to a null encoding. The HttpBody class has been updated to be more resilient to a missing encoding or charset. Additionally, all request classes will now pass in the value of its encoding property, which should now always be non-null.

June 20, 2016

• Improvement: The MockTransport utilities now support expecting and registering handlers for HTTP requests and WS connections that match a Pattern instead of exactly matching a URI. Handlers will also receive the Match instance.

  var response = new MockResponse.ok();
  var webSocket = new MockWSocket();
  
  var uriPattern = new RegExp('(http|ws)s:\/\/example.com\/(.*)');
  
  // Capture any GET request to example.com/
  MockTransports.http.expectPattern('GET', uriPattern, respondWith: response);
  
  // Register a handler for any GET request to https://example.com/
  // The `Match` instance will be given to the handler, where it can be used
  // to read any of the captured groups.
  MockTransports.http.whenPattern(uriPattern, (request, match) async {
    print('path: ${match.group(2)}');
    return response;
  }, method: 'GET');
  
  // Capture any WS connection attempt to example.com/
  MockTransports.webSocket.expectPattern(uriPattern, connectTo: webSocket);
  
  // Register a handler for an WS connection attempt to example.com/
  // The `Match` instance will be given to the handler, where it can be used
  // to read any of the captured groups.
  MockTransports.webSocket.whenPattern(uriPattern, handler:
      (uri, {protocols, headers, match}) async {
    print('path: ${match.group(2)}');
    return webSocket;
  });
  

• Improvement: the content-type for HTTP requests can now be set manually.

  var request = new Request()
    ..uri = Uri.parse('/example')
    ..contentType =
        new MediaType('application', 'x-custom', {'charset': UTF8.name});
  

  • The content-type still has a default value based on the type of request (Request - text/plain, JsonRequest - application/json, etc.).

  • The content-type's charset parameter will still be updated automatically when you set the encoding, but once you manually set contentType, this behavior will stop. In other words, we are assuming that if you set contentType manually, you are intentionally overriding the defaults and are taking responsibility of setting the charset parameter appropriately.

• Bug Fix: the StreamedRequest now properly verifies that the request has not been sent when setting contentType. It will now throw a StateError like the rest of the request types.

June 16, 2016

• Error Messaging: When a response body cannot be properly decoded/encoded using the Encoding dictated by the content-type header, a ResponseFormatException will now be thrown with a much more descriptive message. The content-type, encoding, and body will be included.

June 15, 2016

• Bug Fix: WSocket extends Stream and StreamSink, but was not fulfilling those contracts in all scenarios. In particular:

  • After obtaining a StreamSubscription instance from a call to WSocket.listen(), reassigning the onData(), onError(), and onDone() handlers had no effect.

    var webSocket = await WSocket.connect(...);
    var subscription = webSocket.listen((data) { ... });
    
    // This does nothing:
    subscription.onData((data) { ... });
    // Same goes for onError() and onDone()
    

  • A subscription to a WSocket instance did not properly respect pause and resume signals. This could produce a memory leak by buffering WebSocket events indefinitely.

  • A WSocket instance was immediately listening to the underlying WebSocket and buffering events from the underlying WebSocket until a listener was registered. This is not how a standard Dart Stream works.

  • The SockJS configuration was not properly handling the fact that the SockJS Client produces WebSocket events with a broadcast stream.

  • All of these issues have been addressed, and every WSocket instance should now behave exactly as a standard Stream and StreamSink would, regardless of the platform (VM, browser, SockJS, or mock).

The WSocketCloseEvent class has been deprecated. This class was only used internally and should not have been exported as a part of the public API.

The WSocket implementations are no longer registering an onError handler for the underlying WebSocket stream. If an error occurs on the server, it will not add the error to the stream, it will just close the connection. As a result, the MockWSocket.triggerServerError() method has been deprecated - use MockWSocket.triggerServerClose() instead.

May 4, 2016

• Improvement: FormRequest now supports fields with multiple values.

  var request = new FormRequest()
    ..fields['multi'] = ['one', 'two'];
  

• SDK Compatibility: Dart 1.16 exposed a new Client class from the dart:html library that conflicted with the Client class in this library. This has been fixed by adjusting our imports internally, but it may still affect consumers of this library.

• Documentation: fixed inaccurate documentation around mocking & testing with WebSockets.