一行代碼讓微信、頭條、百度、支付寶小程序支持 cookie

weapp-cookie

一行代碼讓微信、頭條、百度、支付寶小程序支持 cookie，傳送門：github

Intro

小程序原生的 request 網絡請求接口並不支持傳統的 Cookie，但有時候咱們現有的後端接口確於依賴 Cookie（好比服務器用戶登陸態），這個庫可用一行代碼爲你的小程序實現 Cookie 機制，以保證基於 cookie 的服務會話不會失效，與 web 端共用會話機制

Featrues

• 一行代碼讓小程序支持 cookie
• 可以使用 api 獲取、設置 cookie
• 支持 domain/path 做用域

Install

npm install weapp-cookie --save

# 將 npm 包複製到 vendor 文件夾，避免小程序可能不能找到文件（tips：使用 wepy/mpvue 等框架無需此步）
cp -rf ./node_modules/ ./vendor/
複製代碼

Usage

以微信小程序爲例，在小程序根目錄的 app.js 一行代碼引入便可

// app.js
import './vendor/weapp-cookie/index'

// tips: 使用 wepy/mpvue 能夠直接在入口 js 引入 weapp-cookie 模塊
// import 'weapp-cookie'

App({
    onLaunch: function () { }
    // ...
})
複製代碼

原來的 wx.request 調用方式保持不變，引入後 weapp-cookie 會在底層自動代理 wx.request 的接口訪問，以支持 cookie 存儲和發送

// pages/home/index.js

Page({
    onLoad: function () {
        wx.request({
            url: 'https://example.com/login',
            data: {
                username: 'admin',
                password: '123456'
            },
            success: function (res) {
                /* * 接口調用成功後 weapp-cookie 會自動保存後端發送的全部Cookie（好比：SessionID） * 並在後續的全部請求中帶上，以保證基於 cookie 的服務器會話機制不會失效， * 實現與 web 端共用會話機制（無需再手動維護 3rd_session_key） */
            }
        })
    }
})
複製代碼

cookie 操做可經過 api 調用

import cookies from 'weapp-cookie'

// 獲取 cookie
let token = cookies.get('csrf_token', 'example.com')

// 設置 cookie
let cookie = cookies.set('uid', 100, { domain: 'example.com' })

// 刪除 cookie
let isRemoved = cookies.remove('uid', 'example.com')

// 判斷是否存在 cookie
let hasToken = cookies.has('uid', 'example.com')

// ... 詳情請參考 Api

複製代碼

使用和配置別名：因爲微信小程序的安全機制，在小程序插件環境下 wx.request 不容許被重寫，因此需使用內置別名或自定義別名來支持 cookie 請求

import cookies from 'weapp-cookie'

// 使用內置別名
wx.requestWithCookie({
    url: 'https://example.com/user/current',
    success: function (res) {
        console.log(res)
    }
})

// 配置自定義別名
cookies.config({ requestAlias: 'requestx' })

// 使用自定義別名
wx.requestx({
    url: 'https://example.com/user/current',
    success: function (res) {
        console.log(res)
    }
})
複製代碼

Api

CookieStore

import cookies from 'weapp-cookie'

/** * 獲取 cookie 值 * @param {String} name cookie 名稱 * @param {String} [domain] 指定域名（可選） * @return {String} cookie 值 */
cookies.get(String name, String domain)

/** * 設置 cookie * @param {String} name cookie 名稱 * @param {String} value cookie 值 * @param {Object} options cookie 選項 * @param {String} options.domain 設置域名 * @param {String} [options.path] * @param {Date} [options.expires] * @param {Number} [options.maxAge] * @param {Boolean} [options.httpOnly] * @return {Cookie} cookie 對象 */
cookies.set(String name, String value, Object options)

/** * 是否存在某個 cookie * @param {String} name cookie 名稱 * @param {String} [domain] 指定域名（可選，不指定則任意域名包含名稱爲 name 的 cokkie 即爲存在） * @return {Boolean} 是否存在 */
cookies.has(String name, String domain)

/** * 刪除 cookie * @param {Array} name cookie 鍵 * @param {String} [domain] 指定域名（可選，不指定則刪除全部域名中名稱爲 name 的 cookie） * @return {Boolean} 是否刪除成功 */
cookies.remove(String name, String domain)

/** * 獲取 cookie 對象 * @param {String} name cookie 名稱 * @param {String} [domain] 指定域名（可選） * @return {Cookie} cookie 對象 */
cookies.getCookie(String name, String domain)

/** * 獲取 cookies JSON對象 * @param {String} [domain] 指定域名（可選，不指定則獲取包含全部域名的 cookie 值對象） * @return {Object} cookie JSON對象 */
cookies.getCookies(String domain)

/** * 清除 cookie * @param {String} [domain] 指定域名（可選，不指定則清除全部域名 cookie） * @return {Boolean} 是否清除成功 */
cookies.clearCookies (domain)

/** * 獲取全部存儲的域名和 cookies 結構 * @return {Object} obj 結構JSON對象 */
cookies.dir(domain)

複製代碼

Cookie

import cookies from 'weapp-cookie'

// 獲取 cookie 對象
let cookie = cookies.getCookie('uuid', 'example.com')

// ===== cookie 屬性 =====
cookie.name:        String
cookie.value:       String
cookie.domain:      String
cookie.path:        String
cookie.expires:     Date
cookie.maxAge:      Number
cookie.httpOnly:    Boolean

// ===== cookie 方法 =====

/** * 驗證 cookie 是否過時 * @return {Boolean} 是否過時 */
cookie.isExpired()

/** * 驗證 cookie 是否可持久化 * @return {Boolean} 是否可持久化 */
cookie.isPersistence()

複製代碼

若是對你有用，歡迎 star ^_^