Package is unidentified

Overview

A cross-platform dart:io that works on all platforms, including browsers.

You can simply replace dart:io imports with package:universal_io/io.dart.

Licensed under the Apache License 2.0. Some of the source code was derived from Dart SDK, which was obtained under the BSD-style license of Dart SDK. See LICENSE file for details.

APIs added on top of "dart:io"

newUniversalHttpClient
- Returns BrowserHttpClient on browsers and the normal "dart:io" HttpClient on other platforms.
BrowserHttpClient
- A subclass of "dart:io" HttpClient that works on browsers.
BrowserHttpClientRequest
- A subclass of "dart:io" HttpClientRequest that works on browsers.
BrowserHttpClientResponse
- A subclass of "dart:io" HttpClientResponse that works on browsers.
BrowserHttpClientException
- An exception that helps you understand why a HTTP request on a browser may have failed (see explanation below).

Other features

The following features may be deprecated in the future versions (3.x) of the package:

HttpClient
- HttpClient() factory is changed so that it returns BrowserHttpClient on browsers.
Platform
- The package makes methods like Platform.isAndroid and Platform.isMacOS work in the browsers too.
InternetAddress
- The package makes it works in the browsers too.
BytesBuilder
- The package makes it works in the browsers too.

Links

API reference
Github project
- We appreciate feedback, issue reports, and pull requests.

Similar packages

universal_html (cross-platform dart:html)

Getting started

1.Add dependency

In pubspec.yaml:

dependencies:
  universal_io: ^2.2.2

2.Use HTTP client

import 'package:universal_io/io.dart';

Future<void> main() async {
  // HttpClient can be used in browser too!
  HttpClient httpClient = newUniversalHttpClient(); // Recommended way of creating HttpClient.
  final request = await httpClient.getUrl(Uri.parse("https://dart.dev/"));
  final response = await request.close();
}

HTTP client behavior

HTTP client is implemented with XMLHttpRequest (XHR) API on browsers.

XHR causes the following differences with dart:io:

HTTP connection is created only after request.close() has been called.
Same-origin policy limitations. For making cross-origin requests, see documentation below.

Helpful error messages

When requests fail and assertions are enabled, error messages contains descriptions how to fix possible issues such as missing cross-origin headers.

The error messages look like the following:

XMLHttpRequest error.
-------------------------------------------------------------------------------
HTTP method:             PUT
HTTP URL:                http://destination.com/example
Origin:                  http://source.com
Cross-origin:            true
browserCredentialsMode:  false
browserResponseType:     arraybuffer

THE REASON FOR THE XHR ERROR IS UNKNOWN.
(For security reasons, browsers do not explain XHR errors.)

Is the server down? Did the server have an internal error?

Enabling credentials mode would enable use of some HTTP headers in both the
request and the response. For example, credentials mode is required for
sending/receiving cookies. If you think you need to enable 'credentials mode',
do the following:

    final httpClientRequest = ...;
    if (httpClientRequest is BrowserHttpClientRequest) {
      httpClientRequest.browserCredentialsMode = true;
    }

Did the server respond to a cross-origin "preflight" (OPTIONS) request?

Did the server send the following headers?
  * Access-Control-Allow-Origin: http://source.com
    * You can also use wildcard ("*").
    * Always required for cross-origin requests!
  * Access-Control-Allow-Methods: PUT
    * You can also use wildcard ("*").

Sometimes when you do cross-origin requests in browsers, you want to use CORS "credentials mode". This can be achieved with the following pattern:

Future<void> main() async {
    final client = HttpClient();
    final request = client.getUrl(Url.parse('http://example/url'));

    // Enable credentials mode
    if (request is BrowserHttpClientRequest) {
      request.browserCredentialsMode = true;
    }

    // Close request
    final response = await request.close();
    // ...
}

Streaming text responses

The underlying XMLHttpRequest (XHR) API supports response streaming only when responseType is "text".

This package automatically uses responseType "text" based on value of the HTTP request header "Accept". These media types are defined BrowserHttpClient.defaultTextMimes:

"text/*" (any text media type)
"application/grpc-web"
"application/grpc-web+proto"

If you want to disable streaming, use the following pattern:

Future<void> main() async {
    final client = newUniversalHttpClient();
    if (client is BrowserHttpClient) {
      client.textMimes = const {};
    }
    // ...
}

	@override
	Future<void> addStream(Stream<List<int>> stream) async {
	if (_completer.isCompleted) {
	throw StateError('StreamSink is closed');
	}
	if (_addStreamFuture != null) {
	throw StateError('StreamSink is bound to a stream');
	}
	final future = stream.listen((item) {
	add(item);
	}, onError: (error) {
	addError(error);
	}, cancelOnError: true).asFuture(null);
	_addStreamFuture = future;
	await future;
	_addStreamFuture = null;
	return null;
	}

	@override
	void add(List<int> event) {
	if (!_supportsBody) {
	throw StateError('HTTP method $method does not support body');
	}
	if (_completer.isCompleted) {
	throw StateError('StreamSink is closed');
	}
	if (_addStreamFuture != null) {
	throw StateError('StreamSink is bound to a stream');
	}
	_buffer.addAll(event);
	}

	_ContentType(String primaryType, String subType, String? charset,
	Map<String, String?> parameters)
	: _primaryType = primaryType,
	_subType = subType,
	super('') {
	// TODO(40614): Remove once non-nullability is sound.
	String emptyIfNull(String? string) => string ?? '';
	_primaryType = emptyIfNull(_primaryType);
	_subType = emptyIfNull(_subType);
	_value = '$_primaryType/$_subType';
	// TODO(40614): Remove once non-nullability is sound.
	if (charset != null) {
	_ensureParameters()['charset'] = charset.toLowerCase();
	}
	}

dint-dev / universal_io Goto Github PK

universal_io's Introduction

Overview

APIs added on top of "dart:io"

Other features

Links

Similar packages

Getting started

1.Add dependency

2.Use HTTP client

HTTP client behavior

Helpful error messages

Streaming text responses

universal_io's People

Contributors

Stargazers

Watchers

Forkers

universal_io's Issues

Live Demo

Results in various devices

Min repro code

Error

Minimal code to recreate the issue

flutter doctor -v

pubspec dependencies

Recommend Projects

Recommend Topics

Recommend Org

Jobs