如何使用 JavaScript 录制指定 div 元素的内容(非全屏捕获)

胖伟小哥_8122

胖伟小哥_8122

2026-03-29

982人浏览

原创

本文介绍一种不依赖屏幕共享 api 的纯前端方案:通过 canvas 截取目标 div 的视觉内容并转为媒体流,再结合 recordrtc 实现精准录制,避免全屏选择干扰,适用于仪表盘、动画区域、交互组件等局部录制场景。

本文介绍一种不依赖屏幕共享 api 的纯前端方案:通过 canvas 截取目标 div 的视觉内容并转为媒体流,再结合 recordrtc 实现精准录制,避免全屏选择干扰,适用于仪表盘、动画区域、交互组件等局部录制场景。

在 Web 应用中,常需录制页面中某个特定区域(如数据看板、Canvas 动画、SVG 图表或富文本编辑区),而非整个屏幕。但 navigator.mediaDevices.getDisplayMedia() 本质是系统级屏幕捕获 API,强制触发用户选择窗口/标签页,无法限定到 DOM 节点——这正是原代码中“录了整屏”的根本原因。

正确思路是:将目标 div 渲染到 ,再调用 canvas.captureStream() 创建可录制的 MediaStream。该方法无需用户授权屏幕共享,完全可控且静默执行。

✅ 正确实现步骤(含关键细节)

  1. 获取目标元素并创建匹配尺寸的 canvas
    注意使用 clientWidth/clientHeight(含 padding,不含 border/scrollbar),确保渲染无裁剪;若 div 含 transform 或 scale,需额外处理(见下方注意事项)。

  2. 绘制 DOM 内容到 canvas
    ⚠️ context.drawImage(div, ...) 原生不支持直接绘制 HTML 元素!上述答案代码存在兼容性风险。实际应使用 html2canvas 库进行高保真截图:

<!-- 引入 html2canvas -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/html2canvas/1.4.1/html2canvas.min.js"></script>
async function startRecording() {
  const recorderBtn = document.getElementById('recorder'); // 避免变量名冲突
  const targetDiv = document.getElementById('divToRecord');

  if (!targetDiv) throw new Error('Target div not found');

  recorderBtn.innerHTML = 'Stop recording';

  // 使用 html2canvas 截图(支持 CSS、SVG、跨域图片等)
  const canvas = await html2canvas(targetDiv, {
    useCORS: true,      // 允许跨域资源
    logging: false,     // 关闭调试日志
    scale: window.devicePixelRatio // 提升高清屏清晰度
  });

  // 将 canvas 转为 MediaStream(帧率默认 30fps)
  const stream = canvas.captureStream(30);

  // 初始化 RecordRTC(需提前引入 recordrtc.min.js)
  const recorder = new RecordRTCPromisesHandler(stream, {
    type: 'video',
    mimeType: 'video/webm;codecs=vp9' // 推荐 VP9,兼容性好且体积小
  });

  await recorder.startRecording();

  // 示例:3秒后停止(实际应用中应由按钮控制)
  setTimeout(async () => {
    await recorder.stopRecording();
    const blob = await recorder.getBlob();

    // 下载录制文件
    const url = URL.createObjectURL(blob);
    const a = document.createElement('a');
    a.href = url;
    a.download = 'div-recording.webm';
    a.click();
    URL.revokeObjectURL(url);

    recorderBtn.innerHTML = 'Start recording';
  }, 3000);
}

⚠️ 重要注意事项

  • 动态内容限制:html2canvas 是静态快照,无法录制 CSS 动画、Video 标签播放、Canvas 实时绘图等动态效果。如需录制动画,需改用 requestAnimationFrame 循环截图并合成视频(复杂度高,建议评估是否真需此场景)。
  • 样式兼容性:html2canvas 对 filter、backdrop-filter、clip-path 等现代 CSS 支持有限,测试时务必覆盖目标浏览器。
  • 性能优化:高频截图(如 30fps)可能造成主线程压力。对静态内容,可降低帧率(如 captureStream(15));对滚动区域,建议暂停滚动后再录制。
  • RecordRTC 替代方案:若项目已使用 MediaRecorder API,可直接 new MediaRecorder(stream),无需引入 RecordRTC。

✅ 总结

录制指定 div 的核心在于绕过系统级屏幕捕获,转向 DOM 快照流化。html2canvas + canvas.captureStream() 是目前最成熟、兼容性最佳的方案。它赋予开发者对录制范围、时机和样式的完全控制权,是构建专业级 Web 录制功能(如教学演示、Bug 复现、UI 自动化报告)的可靠基础。务必根据实际内容动态性选择合适的技术路径,并始终在目标设备上实测渲染效果与性能表现。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

5466

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1329

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

5404

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

1020

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1976

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3785

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

4973

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

3260

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

1048

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习