# sib-utils

**Repository Path**: katyusha_sib/sib-utils

## Basic Information

- **Project Name**: sib-utils
- **Description**: sib-utils 是基于Vue 封装集成的函数工具库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2023-05-12
- **Last Updated**: 2024-02-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## sib-utils 公共函数工具库

## 安装
```
npm install sib-utils -S
  or
cnpm install sib-utils -S

```
## 引入方式
```
main.js 全局注册
import 'sib-utils';

    or

import sibUtils from 'sib-utils'
import { // } from 'sib-utils'

    or

<script src="//unpkg.com/sib-utils"></script>
```


## sib-utils  Methods

<table>
  <tr>
    <th width=10%, >方法名</th>
    <th width=10%, >参数</th>
    <th width=40%,>说明</th>
    <th width="10%",>默认值</th>
  </tr>

  <tr>
    <td >certainDate</td>
    <td>delay，format</td>
    <td> 获取日期，例如: delay传-5,则返回往前5天的日期 delay传2,则返回今天之后2天的日期 不传或传0,则返回今天日期，format 日期格式化</td>
    <td>format = 'YYYY-MM-DD'</td>
  </tr>

  <tr>
    <td >deepCopy</td>
    <td>source</td>
    <td>传入一个 (typeof source === 'object') 的参数 返回一个深度拷贝后的object类型的数据</td>
    <td>-</td>
  </tr>

  <tr>
    <td >download</td>
    <td>response, fileName</td>
    <td>response：可以传下载的URL或者二进制流，当参数为URL String类型时默认通过a标签访问下载，当参数是对象或者文档流时通过Blob对象转换下载。fileName：文件名，不传就从响应头中获取</td>
    <td>fileName = response.headers['content-disposition']</td>
  </tr>

  <tr>
    <td >isAndroid</td>
    <td>-</td>
    <td>判断当前浏览器环境是否为Android，返回 布尔值</td>
    <td>-</td></td>
  </tr>
  
  <tr>
    <td >isIphone</td>
    <td>-</td>
    <td>判断当前浏览器环境是否为IOS，返回 布尔值</td>
    <td>-</td></td>
  </tr>
    
  <tr>
    <td >isMobile</td>
    <td>callback</td>
    <td>判断当前浏览器环境是否为移动端，返回 布尔值， callback： 返回一个包含环境参数的数组</td>
    <td>-</td></td>
  </tr>
      
  <tr>
    <td >uuid</td>
    <td>-</td>
    <td>UUID 长度是128bit(16字节(128位)),换算为16进制数值(每4位代表一个数值)就是有32个16进制数值组成,中间使用4个-进行分隔,按照8-4-4-4-12的顺序进行分隔。加上中间的横杆,UUID有36个字符。比如:3e350a5c-222a-11eb-abef-0242ac110002</td>
    <td>-</td></td>
  </tr>
</table>


#

## App - H5 通信方法 - 基于DSBridge二次封装
# 源码地址
<ul>
  <li><a href="https://links.jianshu.com/go?to=https%3A%2F%2Fwww.npmjs.com%2Fpackage%2Fdsbridge" target="_blank">JS - DSBridge</a></li>
  <li><a href="https://links.jianshu.com/go?to=https%3A%2F%2Fgithub.com%2Fwendux%2FDSBridge-Android" target="_blank">Android - DSBridge</a></li>
  <li><a href="https://links.jianshu.com/go?to=https%3A%2F%2Fgithub.com%2Fwendux%2FDSBridge-IOS" target="_blank">iOS - DSBridge</a></li>
</ul>

支持与 Android ios 通信 并支持同步/异步调用;
<br> 提示：前提是要app已经编写好 DSBridge 的方法;

<table>
  <tr>
    <th width=10%, >方法名</th>
    <th width=10%, >参数</th>
    <th width=40%,>说明</th>
    <th width="10%",>默认值</th>
  </tr>

  <tr>
    <td >dsBridgeCall</td>
    <td>fnName, params</td>
    <td>同步 - 前端调用app声明的方法 fnName: app方法名， params: 传递给app的参数， 返回app回传的参数。</td>
    <td>-</td>
  </tr>

  <tr>
    <td >dsBridgeCallAsync</td>
    <td>fnName, params, callback</td>
    <td>异步 - 前端调用app声明的方法 fnName: app方法名， params: 传递给app的参数， callback回调方法返回 app回传参数</td>
    <td>-</td>
  </tr>

  <tr>
    <td >dsBridgeRegister</td>
    <td>fnName, callback</td>
    <td>注册方法 - app调用前端声明的方法，fnName：方法名 供app调用 callback： app回传参数 ，最终 return 的值可以回传给app</td>
    <td>-</td>
  </tr>
</table>

#

## 示例

```
import { dsBridgeCall, dsBridgeCallAsync, dsBridgeRegister } from 'sib-utils';


// 同步 - 前端调用app声明的方法
const data = dsBridgeCall('getAppParams', params);

// 异步 - 前端调用app声明的方法
dsBridgeCallAsync('openWXMiniProgram', params, async (data) => {
  await console.log(data);
})

// 注册方法 - app调用前端声明的方法
dsBridgeRegister('setApp', (params) => {
  return 'hello App';
})

```