cookie_jar 0.0.2 copy "cookie_jar: ^0.0.2" to clipboard
cookie_jar: ^0.0.2 copied to clipboard

outdatedDart 1 only

A cookie manager for http requests in Dart, by which you can deal with the complex cookie policy and persist cookies easily.

CookieJar #

build statud Pub coverage support

A cookie manager for http requests in Dart, by which you can deal with the complex cookie policy and persist cookies easily.

Add dependency #

dependencies:
  dio: ^0.0.2

Usage #

A simple usage example:

import 'package:cookie_jar/cookie_jar.dart';
void main() async {
  List<Cookie> cookies = [
    new Cookie("name", "wendux")
    new Cookie("location", "china")
  ];
    
  var cj = new DefaultCookieJar();
  cj.saveFromResponse(Uri.parse("https://www.baidu.com/"), cookies);
  List<Cookie> results = cj.loadForRequest(Uri.parse("https://www.baidu.com/xx"));
  print(results);  
}    
       

Classes #

DefaultCookieJar #

DefaultCookieJar is a default cookie manager which implements the standard cookie policy declared in RFC. DefaultCookieJar saves the cookies in RAM, so if the application exit, all cookies will be cleared.

PersistCookieJar #

PersistCookieJar is a cookie manager which implements the standard cookie policy declared in RFC. PersistCookieJar persists the cookies in files, so if the application exit, the cookies always exist unless call delete explicitly.

SerializableCookie #

This class is a wrapper for Cookie class. Because the Cookie class doesn't support Json serialization, for the sake of persistence, we use this class instead of it.

APIs #

void saveFromResponse(Uri uri, List

Save the cookies for specified uri.

List

Load the cookies for specified uri.

delete(Uri uri,[bool withDomainSharedCookie = false] )

Delete cookies for specified uri. This API will delete all cookies for the uri.host, it will ignored the uri.path.

If withDomainSharedCookie is true , will delete the domain-shared cookies.

Note: This API is only available in PersistCookieJar class.

Working with HttpClient #

Using DefaultCookieJar or PersistCookieJar manages HttpClient 's request/response cookies is very easy:

var cj=new DefaultCookieJar();
...
request= await httpClient.openUrl(options.method, uri);
request.cookies.addAll(cj.loadForRequest(uri));
response= await request.close();
cj.saveFromResponse(uri, response.cookies);

Working with dio #

dio is a powerful Http client for Dart, which supports Interceptors, Global configuration, FormData, File downloading, Timeout etc. And dio supports to manage cookies with cookie_jar, the simple example is:

var dio = new Dio();
dio.cookieJar=new PersistCookieJar("./cookies");
Response<String>  response = await dio.get("https://www.baidu.com");

More details about dio see : https://github.com/flutterchina/dio .

This open source project authorized by https://flutterchina.club , and the license is MIT.

Features and bugs #

Please file feature requests and bugs at the issue tracker.

68
likes
0
pub points
98%
popularity

Publisher

verified publisherflutterchina.club

A cookie manager for http requests in Dart, by which you can deal with the complex cookie policy and persist cookies easily.

Repository (GitHub)
View/report issues

License

unknown (LICENSE)

More

Packages that depend on cookie_jar