loreq 1.0.1 copy "loreq: ^1.0.1" to clipboard
loreq: ^1.0.1 copied to clipboard

Future based Http request package for the Dart and browser.

Future based Http request package for the Dart and browser. It is inspired by axios package in Node.js

Pub Version Coverage Status License

Install #

# recommened install
dart pub add loreq

Usage #

Import loreq in your file.

import 'package:loreq/loreq.dart';

void main() {
  loreq('https://example.com/cars?brand=bmw')
    .then((data) => print(data));
}

And now we got the bmw brands from /cars on our server and printed them on the terminal. How simple isn't it?

import 'package:loreq/loreq.dart';

void main() {
  loreq('https://example.com/cars', params: {'brand': 'bmw'})
    .then((data) => print(data));
}

Post, Put and Delete requests #

When using the loreq function, the get request is automatically thrown if no method is specified. However, you can use other request types if you want.

Post

import 'package:loreq/loreq.dart';

void main() {
  loreq('https://example.com/users/new', params: {'id': 12345, 'username': 'JohnDoe'} method: 'POST')
    .then((data) => print(data));
}

Put

import 'package:loreq/loreq.dart';

void main() {
  loreq('https://example.com/password/change', params: {'id': 12345, 'newPassword': 'himom'} method: 'PUT')
    .then((data) => print(data));
}

Delete

import 'package:loreq/loreq.dart';

void main() {
  loreq('https://example.com/users/delete', params: {'id': 12345, 'password': 'himom'} method: 'DELETE')
    .then((data) => print(data));
}

Browser #

If you want to use Loreq in normal Javascript, you don't need to convert your Dart code to Javascript code. Loreq already comes with a file named browser.js.

// ES6+
import loreq from 'packages/loreq/web/browser.mjs'
// CommonJS (for Node.js)
const loreq = require('packages/loreq/web/node.js')

loreq('https://example.com/packages?id=loreq')
  .then(data => console.log(data))

You can also use post, put and delete requests as you would in Dart.

// ES6+
import loreq from 'packages/loreq/web/browser.mjs'
// CommonJS (for Node.js)
const loreq = require('packages/loreq/web/node.js')

loreq('https://example.com/packages/new', { 
    params: { name: 'loreq', creatorToken: /* ... */},
    method: 'POST'
}).then(data => console.log(data))

Errors #

You can access data['error'] to see if the response after a request returns an error.

import 'package:loreq/loreq.dart';

void main() {
 loreq('https://example.com/packages/aPackageForFake') // An incorrect request
    .then((data) {
      if (data['error']) {
        print('Something went wrong')
      } else {
        // ...
      }
    })
}

Example #

See example for see usage example

Changelog #

See changelog for see changelog

1
likes
150
pub points
0%
popularity

Publisher

unverified uploader

Future based Http request package for the Dart and browser.

Homepage
Repository (GitHub)
View/report issues

Documentation

Documentation
API reference

License

MIT (LICENSE)

Dependencies

log_symbols

More

Packages that depend on loreq