The HTTP Client for WeChat Mini Program

Wave is an HTTP client designed for WeChat Mini Programs. It aims to enhance the developer experience when sending HTTP requests.

Installation

To install the package, navigate to the root directory of your WeChat Mini Program. You can install it using NPM:

npm i @beautiful-bubble/wave

After installation, remember to run the "Build NPM Package" command in the WeChat Mini Program development tools.

Sending HTTP Requests

Wave features a set of intuitive APIs that help you quickly create HTTP requests.

import { Client } from '@beautiful-bubble/wave'

Client.new().get('http://www.example.com')
Client.new().post('http://www.example.com')
Client.new().put('http://www.example.com')
Client.new().delete('http://www.example.com')

You can also pass an object as the second parameter along with the request to specify the body data. The default content type for HTTP requests is set to JSON. Since HTTP GET requests do not have a body, the object will be formatted as a query string.

Client.new().get('http://www.example.com/api/users', ['search' => 'Zhineng'])

When you're ready to get the response, you can await the invocation. Wave also provides a comprehensive Response instance with intuitive APIs.

const response = await Client.new().get('http://www.example.com')
console.log(response.data())

We understand that you may need to abort outgoing HTTP requests in some situations; in that case, you can simply retrieve the request task without using the await operator.

const { task } = Client.new().get('http://www.example.com')
task.abort()

Configure base URL

It can be tedious to specify the full endpoint in every HTTP request throughout the application. You can set the base URL at the application level in the app.ts or app.js file, and all subsequent HTTP requests will then respect this endpoint.

// app.ts

Client.baseUrl('http://www.example.com')

// page.ts

Client.new().get('/api/users')

Request timeout

WeChat Mini Programs have a one-minute default timeout for HTTP requests. You can shorten this by passing the desired time in milliseconds to the timeout API.

Client.new().timeout(3000).get('/')

Middleware

Wave streamlines the organization and reuse of code for HTTP requests. Through its middleware, you can intercept or modify HTTP requests, such as by configuring authentication tokens or recording outgoing requests.

Client.use((request, next) => {
  return next(request.withHeader('Authorization', 'Bearer ...'))
})

License

The package is released under the MIT license.