Document that Socket.addError throws.

brianquinlan · Commit Queue · commit 3ee9c0b792cc · 2023-01-17T23:22:35.000Z
Bug:#31504 Change-Id: Ib9f9b0fb2844b92fe5375da9b843b1d9777a936a Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/278947 Reviewed-by: Lasse Nielsen <lrn@google.com> Commit-Queue: Brian Quinlan <bquinlan@google.com>
diff --git a/sdk/lib/_internal/vm/bin/socket_patch.dart b/sdk/lib/_internal/vm/bin/socket_patch.dart
@@ -2226,6 +2226,10 @@ class _Socket extends Stream<Uint8List> implements Socket {
 
   void add(List<int> bytes) => _sink.add(bytes);
 
+  /// Unsupported operation on sockets.
+  ///
+  /// Throws an [UnsupportedError] because errors cannot be transmitted over a
+  /// [Socket].
   void addError(Object error, [StackTrace? stackTrace]) {
     throw new UnsupportedError("Cannot send errors on sockets");
   }

Original file line number	Diff line number	Diff line change
`@@ -2226,6 +2226,10 @@ class _Socket extends Stream<Uint8List> implements Socket {`
`2226`	`2226`
`2227`	`2227`	`void add(List<int> bytes) => _sink.add(bytes);`
`2228`	`2228`
	`2229`	`+ /// Unsupported operation on sockets.`
	`2230`	`+ ///`
	`2231`	`+ /// Throws an [UnsupportedError] because errors cannot be transmitted over a`
	`2232`	`+ /// [Socket].`
`2229`	`2233`	`void addError(Object error, [StackTrace? stackTrace]) {`
`2230`	`2234`	`throw new UnsupportedError("Cannot send errors on sockets");`
`2231`	`2235`	`}`