Vue 大文件上傳和斷點續(xù)傳的實現(xiàn)
文件上傳的 2 套方案
基于文件流(form-data)
element-ui 框架的上傳組件,就是默認(rèn)基于文件流的。
- 數(shù)據(jù)格式:form-data;
- 傳遞的數(shù)據(jù): file 文件流信息;filename 文件名字

客戶端把文件轉(zhuǎn)換為 base64
通過 fileRead.readAsDataURL(file) 轉(zhuǎn)為 base64 字符串后,要用 encodeURIComponent 編譯再發(fā)送, 發(fā)送的數(shù)據(jù)經(jīng)由 qs.stringify 處理,請求頭添加 "Content-Type": "application/x-www-form-urlencoded"
大文件上傳
首先借助 element-ui 搭建下頁面。因為要自定義一個上傳的實現(xiàn),所以 el-upload 組件的 auto-upload 要設(shè)定為 false;action 為必選參數(shù),此處可以不填值。
<template>
<div id="app">
<!-- 上傳組件 -->
<el-upload action drag :auto-upload="false" :show-file-list="false" :on-change="handleChange">
<i class="el-icon-upload"></i>
<div class="el-upload__text">將文件拖到此處,或<em>點擊上傳</em></div>
<div class="el-upload__tip" slot="tip">大小不超過 200M 的視頻</div>
</el-upload>
<!-- 進度顯示 -->
<div class="progress-box">
<span>上傳進度:{{ percent.toFixed() }}%</span>
<el-button type="primary" size="mini" @click="handleClickBtn">{{ upload | btnTextFilter}}</el-button>
</div>
<!-- 展示上傳成功的視頻 -->
<div v-if="videoUrl">
<video :src="videoUrl" controls />
</div>
</div>
</template>
獲取到文件對象并轉(zhuǎn)成 ArrayBuffer 對象
轉(zhuǎn)成 ArrayBuffer 是因為后面要用 SparkMD5 這個庫生成 hash 值,對文件進行命名
async handleChange(file) {
const fileObj = file.raw
try{
const buffer = await this.fileToBuffer(fileObj)
console.log(buffer)
}catch(e){
console.log(e)
}
}
打印 buffer 結(jié)果如下圖

注意:before-upload 函數(shù)和 on-change 函數(shù)的參數(shù)都有 file,但是 on-change 中的 file 不是 File 對象,要獲取File 對象需要通過 file.raw。 這里用到 FileReader 類將 File 對象轉(zhuǎn) ArrayBuffer 對象,因為是異步過程,所以用 Promise 封裝:
// 將 File 對象轉(zhuǎn)為 ArrayBuffer
fileToBuffer(file) {
return new Promise((resolve, reject) => {
const fr = new FileReader()
fr.onload = e => {
resolve(e.target.result)
}
fr.readAsArrayBuffer(file)
fr.onerror = () => {
reject(new Error('轉(zhuǎn)換文件格式發(fā)生錯誤'))
}
})
}
創(chuàng)建切片
可以通過固定大小或是固定數(shù)量把一個文件分成好幾個部分,為了避免由于 js 使用的 IEEE754 二進制浮點數(shù)算術(shù)標(biāo)準(zhǔn)可能導(dǎo)致的誤差,我決定用固定大小的方式對文件進行切割,設(shè)定每個切片的大小為 2M,即 2M = 21024KB = 21024*1024B = 2097152B。切割文件用到的是 Blob.slice()
// 將文件按固定大?。?M)進行切片,注意此處同時聲明了多個常量
const chunkSize = 2097152,
chunkList = [], // 保存所有切片的數(shù)組
chunkListLength = Math.ceil(fileObj.size / chunkSize), // 計算總共多個切片
suffix = /\.([0-9A-z]+)$/.exec(fileObj.name)[1] // 文件后綴名
// 根據(jù)文件內(nèi)容生成 hash 值
const spark = new SparkMD5.ArrayBuffer()
spark.append(buffer)
const hash = spark.end()
// 生成切片,這里后端要求傳遞的參數(shù)為字節(jié)數(shù)據(jù)塊(chunk)和每個數(shù)據(jù)塊的文件名(fileName)
let curChunk = 0 // 切片時的初始位置
for (let i = 0; i < chunkListLength; i++) {
const item = {
chunk: fileObj.slice(curChunk, curChunk + chunkSize),
fileName: `${hash}_${i}.${suffix}` // 文件名規(guī)則按照 hash_1.jpg 命名
}
curChunk += chunkSize
chunkList.push(item)
}
console.log(chunkList)
選擇一個文件后將打印得到諸如下圖的結(jié)果

發(fā)送請求
發(fā)送請求可以是并行的或是串行的,這里選擇串行發(fā)送。每個切片都新建一個請求,為了能實現(xiàn)斷點續(xù)傳,我們將請求封裝到函數(shù) fn 里,用一個數(shù)組 requestList 來保存請求集合,然后封裝一個 send 函數(shù),用于請求發(fā)送,這樣一旦按下暫停鍵,可以方便的終止上傳,代碼如下:
sendRequest() {
const requestList = [] // 請求集合
this.chunkList.forEach(item => {
const fn = () => {
const formData = new FormData()
formData.append('chunk', item.chunk)
formData.append('filename', item.fileName)
return axios({
url: '/single3',
method: 'post',
headers: { 'Content-Type': 'multipart/form-data' },
data: formData
}).then(res => {
if (res.data.code === 0) { // 成功
if (this.percentCount === 0) {
this.percentCount = 100 / this.chunkList.length
}
this.percent += this.percentCount // 改變進度
}
})
}
requestList.push(fn)
})
let i = 0 // 記錄發(fā)送的請求個數(shù)
const send = async () => {
// if ('暫停') return
if (i >= requestList.length) {
// 發(fā)送完畢
return
}
await requestList[i]()
i++
send()
}
send() // 發(fā)送請求
},
axios 部分也可以直接寫成下面這種形式:
axios.post('/single3', formData, {
headers: { 'Content-Type': 'multipart/form-data' }
})
所有切片發(fā)送成功后
根據(jù)后端接口需要再發(fā)送一個 get 請求并把文件的 hash 值傳給服務(wù)器,我們定義一個 complete 方法來實現(xiàn),這里假定發(fā)送的為視頻文件
const complete = () => {
axios({
url: '/merge',
method: 'get',
params: { hash: this.hash }
}).then(res => {
if (res.data.code === 0) { // 請求發(fā)送成功
this.videoUrl = res.data.path
}
})
}
這樣就能在文件發(fā)送成功后在頁面瀏覽到發(fā)送的視頻了。
斷點續(xù)傳
首先是暫停按鈕文字的處理,用了一個過濾器,如果 upload 值為 true 則顯示“暫?!?,否則顯示“繼續(xù)”:
filters: {
btnTextFilter(val) {
return val ? '暫停' : '繼續(xù)'
}
}
當(dāng)按下暫停按鈕,觸發(fā) handleClickBtn 方法
handleClickBtn() {
this.upload = !this.upload
// 如果不暫停則繼續(xù)上傳
if (this.upload) this.sendRequest()
}
在發(fā)送切片的 send 方法的開頭添加 if (!this.upload) return,這樣只要 upload 這個變量為 false 就不會繼續(xù)上傳了。為了在暫停完后可以繼續(xù)發(fā)送,需要在每次成功發(fā)送一個切片后將這個切片從 chunkList 數(shù)組里刪除 this.chunkList.splice(index, 1)
代碼匯總
<template>
<div id="app">
<!-- 上傳組件 -->
<el-upload action drag :auto-upload="false" :show-file-list="false" :on-change="handleChange">
<i class="el-icon-upload"></i>
<div class="el-upload__text">將文件拖到此處,或<em>點擊上傳</em></div>
<div class="el-upload__tip" slot="tip">大小不超過 200M 的視頻</div>
</el-upload>
<!-- 進度顯示 -->
<div class="progress-box">
<span>上傳進度:{{ percent.toFixed() }}%</span>
<el-button type="primary" size="mini" @click="handleClickBtn">{{ upload | btnTextFilter}}</el-button>
</div>
<!-- 展示上傳成功的視頻 -->
<div v-if="videoUrl">
<video :src="videoUrl" controls />
</div>
</div>
</template>
<script>
import SparkMD5 from "spark-md5"
import axios from "axios"
export default {
name: 'App3',
filters: {
btnTextFilter(val) {
return val ? '暫停' : '繼續(xù)'
}
},
data() {
return {
percent: 0,
videoUrl: '',
upload: true,
percentCount: 0
}
},
methods: {
async handleChange(file) {
if (!file) return
this.percent = 0
this.videoUrl = ''
// 獲取文件并轉(zhuǎn)成 ArrayBuffer 對象
const fileObj = file.raw
let buffer
try {
buffer = await this.fileToBuffer(fileObj)
} catch (e) {
console.log(e)
}
// 將文件按固定大小(2M)進行切片,注意此處同時聲明了多個常量
const chunkSize = 2097152,
chunkList = [], // 保存所有切片的數(shù)組
chunkListLength = Math.ceil(fileObj.size / chunkSize), // 計算總共多個切片
suffix = /\.([0-9A-z]+)$/.exec(fileObj.name)[1] // 文件后綴名
// 根據(jù)文件內(nèi)容生成 hash 值
const spark = new SparkMD5.ArrayBuffer()
spark.append(buffer)
const hash = spark.end()
// 生成切片,這里后端要求傳遞的參數(shù)為字節(jié)數(shù)據(jù)塊(chunk)和每個數(shù)據(jù)塊的文件名(fileName)
let curChunk = 0 // 切片時的初始位置
for (let i = 0; i < chunkListLength; i++) {
const item = {
chunk: fileObj.slice(curChunk, curChunk + chunkSize),
fileName: `${hash}_${i}.${suffix}` // 文件名規(guī)則按照 hash_1.jpg 命名
}
curChunk += chunkSize
chunkList.push(item)
}
this.chunkList = chunkList // sendRequest 要用到
this.hash = hash // sendRequest 要用到
this.sendRequest()
},
// 發(fā)送請求
sendRequest() {
const requestList = [] // 請求集合
this.chunkList.forEach((item, index) => {
const fn = () => {
const formData = new FormData()
formData.append('chunk', item.chunk)
formData.append('filename', item.fileName)
return axios({
url: '/single3',
method: 'post',
headers: { 'Content-Type': 'multipart/form-data' },
data: formData
}).then(res => {
if (res.data.code === 0) { // 成功
if (this.percentCount === 0) { // 避免上傳成功后會刪除切片改變 chunkList 的長度影響到 percentCount 的值
this.percentCount = 100 / this.chunkList.length
}
this.percent += this.percentCount // 改變進度
this.chunkList.splice(index, 1) // 一旦上傳成功就刪除這一個 chunk,方便斷點續(xù)傳
}
})
}
requestList.push(fn)
})
let i = 0 // 記錄發(fā)送的請求個數(shù)
// 文件切片全部發(fā)送完畢后,需要請求 '/merge' 接口,把文件的 hash 傳遞給服務(wù)器
const complete = () => {
axios({
url: '/merge',
method: 'get',
params: { hash: this.hash }
}).then(res => {
if (res.data.code === 0) { // 請求發(fā)送成功
this.videoUrl = res.data.path
}
})
}
const send = async () => {
if (!this.upload) return
if (i >= requestList.length) {
// 發(fā)送完畢
complete()
return
}
await requestList[i]()
i++
send()
}
send() // 發(fā)送請求
},
// 按下暫停按鈕
handleClickBtn() {
this.upload = !this.upload
// 如果不暫停則繼續(xù)上傳
if (this.upload) this.sendRequest()
},
// 將 File 對象轉(zhuǎn)為 ArrayBuffer
fileToBuffer(file) {
return new Promise((resolve, reject) => {
const fr = new FileReader()
fr.onload = e => {
resolve(e.target.result)
}
fr.readAsArrayBuffer(file)
fr.onerror = () => {
reject(new Error('轉(zhuǎn)換文件格式發(fā)生錯誤'))
}
})
}
}
}
</script>
<style scoped>
.progress-box {
box-sizing: border-box;
width: 360px;
display: flex;
justify-content: space-between;
align-items: center;
margin-top: 10px;
padding: 8px 10px;
background-color: #ecf5ff;
font-size: 14px;
border-radius: 4px;
}
</style>
效果如下圖:

One More Thing
FormData
這里發(fā)送數(shù)據(jù)用到了 FormData,如果編碼類型被設(shè)為 "multipart/form-data",它會使用和表單一樣的格式。
FormData.append()
會添加一個新值到 FormData 對象內(nèi)的一個已存在的鍵中,如果鍵不存在則會添加該鍵。該方法可以傳遞 3 個參數(shù),formData.append(name, value, filename),其中 filename 為可選參數(shù),是傳給服務(wù)器的文件名稱, 當(dāng)一個 Blob 或 File 被作為第二個參數(shù)的時候, Blob 對象的默認(rèn)文件名是 "blob"。 File 對象的默認(rèn)文件名是該文件的名稱。
到此這篇關(guān)于Vue 大文件上傳和斷點續(xù)傳的實現(xiàn)的文章就介紹到這了,更多相關(guān)Vue 大文件上傳和斷點續(xù)傳內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
安裝@vue/cli報錯npmERR gyp ERR問題及解決
這篇文章主要介紹了安裝@vue/cli報錯npmERR gyp ERR問題及解決方案,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2022-08-08
vue3中使用ant-design-vue的layout組件實現(xiàn)動態(tài)導(dǎo)航欄和面包屑功能
這篇文章主要介紹了vue3中使用ant-design-vue的layout組件實現(xiàn)動態(tài)導(dǎo)航欄和面包屑功能,基于一個新建的Vue3項目上實現(xiàn),本文結(jié)合示例代碼給大家介紹的非常詳細(xì),需要的朋友可以參考下2023-01-01
淺析Proxy可以優(yōu)化vue的數(shù)據(jù)監(jiān)聽機制問題及實現(xiàn)思路
這篇文章主要介紹了淺析Proxy可以優(yōu)化vue的數(shù)據(jù)監(jiān)聽機制問題及實現(xiàn)思路,需要的朋友可以參考下2018-11-11
vue3+vite2實現(xiàn)動態(tài)綁定圖片的優(yōu)雅解決方案
這篇文章主要為大家詳細(xì)介紹了vue3+vite2實現(xiàn)動態(tài)綁定圖片的優(yōu)雅解決方案,文中的示例代碼簡潔易懂,感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2023-08-08
vue3+element-plus動態(tài)路由菜單示例代碼
這篇文章主要介紹了vue3+element-plus動態(tài)路由菜單示例代碼,代碼簡單易懂,對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2023-11-11

