TestDefaultBinaryMessenger class

A BinaryMessenger subclass that is used as the default binary messenger under testing environment.

It tracks status of data sent across the Flutter platform barrier, which is useful for testing frameworks to monitor and synchronize against the platform messages.

Messages from the framework to the platform

Messages are sent from the framework to the platform via the send method.

To intercept a message sent from the framework to the platform, consider using setMockMessageHandler, setMockDecodedMessageHandler, and setMockMethodCallHandler (see also checkMockMessageHandler).

To wait for all pending framework-to-platform messages, the platformMessagesFinished getter provides an appropriate Future. The pendingMessageCount getter returns the current number of outstanding messages.

Messages from the platform to the framework

The platform sends messages via the ChannelBuffers API. Mock messages can be sent to the framework using handlePlatformMessage.

Listeners for these messages are configured using setMessageHandler.

Inheritance
Available Extensions

Constructors

TestDefaultBinaryMessenger(BinaryMessenger delegate, {Map<String, MessageHandler> outboundHandlers = const <String, MessageHandler>{}})
Creates a TestDefaultBinaryMessenger instance.

Properties

allMessagesHandler AllMessagesHandler?
Handler that intercepts and responds to outgoing messages, pretending to be the platform, for all channels.
getter/setter pair
delegate BinaryMessenger
The delegate BinaryMessenger.
final
hashCode int
The hash code for this object.
no setterinherited
pendingMessageCount int
The number of incomplete/pending calls sent to the platform channels.
no setter
platformMessagesFinished Future<void>
Returns a Future that completes after all the platform calls are finished.
no setter
runtimeType Type
A representation of the runtime type of the object.
no setterinherited

Methods

checkMockMessageHandler(String channel, Object? handler) bool
Returns true if the handler argument matches the handler previously passed to setMockMessageHandler, setMockDecodedMessageHandler, or setMockMethodCallHandler.
handlePlatformMessage(String channel, ByteData? data, PlatformMessageResponseCallback? callback) Future<ByteData?>
Send a mock message to the framework as if it came from the platform.
override
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
send(String channel, ByteData? message) Future<ByteData?>?
Send a binary message to the platform plugins on the given channel.
override
setMessageHandler(String channel, MessageHandler? handler) → void
Set a callback for receiving messages from the platform plugins on the given channel, without decoding them.
override
setMockDecodedMessageHandler<T>(BasicMessageChannel<T> channel, Future<T> handler(T? message)?) → void
Set a callback for intercepting messages sent to the platform on the given channel.
setMockMessageHandler(String channel, MessageHandler? handler, [Object? identity]) → void
Set a callback for intercepting messages sent to the platform on the given channel, without decoding them.
setMockMethodCallHandler(MethodChannel channel, Future<Object?>? handler(MethodCall message)?) → void
Set a callback for intercepting method calls sent to the platform on the given channel.
setMockStreamHandler(EventChannel channel, MockStreamHandler? handler) → void
Set a handler for intercepting stream events sent to the platform on the given channel.
toString() String
A string representation of this object.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited