request 0.1.1 copy "request: ^0.1.1" to clipboard
request: ^0.1.1 copied to clipboard

A minimal abstraction of the 'http' package's 'get' and 'post' methods that automatically throws an exception when any non-200 status code is returned.

request #

A minimal abstraction of the 'http' package's 'get' and 'post' methods that automatically throws an exception when any non-200 status code is returned.

Usage #

import 'package:request/request.dart' as http;

Like http, request exposes the [get] and [post] methods, which directly wrap http's equivalent methods, but throw a [HttpStatusException] when any status other than 200 is returned.

final response = await http.get(uri);
final reponse = await http.post(uri);

Additionally, request exposes the [request] method, which wraps [get] and returns the response's body as a [String]. Like [get] and [post], an exception will be thrown when any status other than 200 is returned.

final body = await http.request(uri);

Uri Extension Methods #

[get], [post], and [request] are also available as extension methods on Dart's [Uri] object.

final url = Uri.parse('https://pub.dev/packages/request');
final body = await url.request();

HttpStatusException #

Returned [HttpStatusException]s contain the original [response], and has getters for the requested [url], [statusCode] and [message].

[message] defaults to [response.reasonPhrase], and if null, falls back to the standard status code phrases as defined by the W3C.

0
likes
120
pub points
61%
popularity

Publisher

verified publisherjamesalex.dev

A minimal abstraction of the 'http' package's 'get' and 'post' methods that automatically throws an exception when any non-200 status code is returned.

Repository (GitHub)
View/report issues

Documentation

API reference

License

BSD-2-Clause (LICENSE)

Dependencies

http

More

Packages that depend on request