← 返回首页
Array.prototype.copyWithin() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
切换侧边栏
  1. 面向开发者的 Web 技术
  2. JavaScript
  3. JavaScript 参考
  4. JavaScript 标准内置对象
  5. Array
  6. Array.prototype.copyWithin()
主题
  • 跟随系统
  • 浅色
  • 深色
中文 (简体)
记住语言 了解更多

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Array.prototype.copyWithin()

基线 广泛可用

自 2015年9月 起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

copyWithin() 方法浅复制数组的一部分到同一数组中的另一个位置，并返回它，不会改变原数组的长度。

本文内容

尝试一下

const array1 = ["a", "b", "c", "d", "e"]; // Copy to index 0 the element at index 3 console.log(array1.copyWithin(0, 3, 4)); // Expected output: Array ["d", "b", "c", "d", "e"] // Copy to index 1 all elements from index 3 to the end console.log(array1.copyWithin(1, 3)); // Expected output: Array ["d", "d", "e", "d", "e"]

语法

js
copyWithin(target) copyWithin(target, start) copyWithin(target, start, end)

参数

target

序列开始替换的目标位置，以 0 为起始的下标表示，且将被转换为整数

  • 负索引将从数组末尾开始计数——如果 target < 0，则实际是 target + array.length。
  • 如果 target < -array.length，则使用 0。
  • 如果 target >= array.length，则不会拷贝任何内容。
  • 如果 target 位于 start 之后，则复制只会持续到 array.length 结束（换句话说，copyWithin() 永远不会扩展数组）。
start 可选

要复制的元素序列的起始位置，以 0 为起始的下标表示，且将被转换为整数

  • 负索引将从数组末尾开始计数——如果 start < 0，则实际是 start + array.length。
  • 如果省略 start 或 start < -array.length，则默认为 0。
  • 如果 start >= array.length，则不会拷贝任何内容。
end 可选

要复制的元素序列的结束位置，以 0 为起始的下标表示，且将被转换为整数。copyWithin 将会拷贝到该位置，但不包括 end 这个位置的元素。

  • 负索引将从数组末尾开始计数——如果 end < 0，则实际是 end + array.length。
  • 如果 end < -array.length，则使用0。
  • 如果省略 end 或 end >= array.length，则默认为 array.length，这将导致直到数组末尾的所有元素都被复制。
  • 如果 end 位于 start 之前，则不会拷贝任何内容。

返回值

改变后的数组。

描述

copyWithin() 方法的工作原理类似于 C 和 C++ 的 memmove，是一种移动数组数据的高性能方法，与 TypedArray 的同名方法类似。序列在一次中操作被复制和粘贴；即使复制和粘贴区域重叠，粘贴的序列也将具有复制值。

copyWithin() 是修改方法。它不会改变 this 指向的对象（数组或类数组）的长度，但会更改其的内容，并在必要时创建新属性或删除现有属性。

copyWithin() 方法保留空槽。如果要复制的区域是稀疏的，则原来的空槽会被删除并被替换为拷贝的空槽。

copyWithin() 方法是通用的。它只期望 this 值具有 length 属性和整数键属性。虽然字符串也是类似数组的，但这种方法不适用于它们，因为字符串是不可变的。

示例

使用 copyWithin()

js
console.log([1, 2, 3, 4, 5].copyWithin(-2)); // [1, 2, 3, 1, 2] console.log([1, 2, 3, 4, 5].copyWithin(0, 3)); // [4, 5, 3, 4, 5] console.log([1, 2, 3, 4, 5].copyWithin(0, 3, 4)); // [4, 2, 3, 4, 5] console.log([1, 2, 3, 4, 5].copyWithin(-2, -3, -1)); // [1, 2, 3, 3, 4]

在稀疏数组上使用 copyWithin()

copyWithin() 将保留空插槽。

js
console.log([1, , 3].copyWithin(2, 1, 2)); // [1, empty, empty]

在非数组对象上调用 copyWithin()

copyWithin() 方法读取 this 的 length 属性，然后操作所涉及的整数索引。

js
const arrayLike = { length: 5, 3: 1, }; console.log(Array.prototype.copyWithin.call(arrayLike, 0, 3)); // { '0': 1, '3': 1, length: 5 } console.log(Array.prototype.copyWithin.call(arrayLike, 3, 1)); // { '0': 1, length: 5 } // '3' 属性被删除，因为在复制的源中是一个空槽

规范

规范
ECMAScript® 2027 Language Specification
# sec-array.prototype.copywithin

浏览器兼容性

启用 JavaScript 以查看此浏览器兼容性表。

参见

帮助改进 MDN

此页面对您有帮助吗？
是 否
了解如何参与贡献

此页面最后更新于 2025年10月23日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题
  1. JavaScript 标准内置对象
  2. Array
  3. 构造函数
    1. Array() 构造函数
  4. 静态方法
    1. Array.from()
    2. Array.fromAsync()
    3. Array.isArray()
    4. Array.of()
  5. 静态属性
    1. Array[Symbol.species]
  6. 实例方法
    1. Array.prototype.at()
    2. Array.prototype.concat()
    3. Array.prototype.copyWithin()
    4. Array.prototype.entries()
    5. Array.prototype.every()
    6. Array.prototype.fill()
    7. Array.prototype.filter()
    8. Array.prototype.find()
    9. Array.prototype.findIndex()
    10. findLast()
    11. Array.prototype.findLastIndex()
    12. Array.prototype.flat()
    13. Array.prototype.flatMap()
    14. Array.prototype.forEach()
    15. Array.prototype.includes()
    16. Array.prototype.indexOf()
    17. Array.prototype.join()
    18. Array.prototype.keys()
    19. Array.prototype.lastIndexOf()
    20. Array.prototype.map()
    21. Array.prototype.pop()
    22. Array.prototype.push()
    23. Array.prototype.reduce()
    24. Array.prototype.reduceRight()
    25. Array.prototype.reverse()
    26. Array.prototype.shift()
    27. Array.prototype.slice()
    28. Array.prototype.some()
    29. Array.prototype.sort()
    30. Array.prototype.splice()
    31. Array.prototype.toLocaleString()
    32. Array.prototype.toReversed()
    33. Array.prototype.toSorted()
    34. Array.prototype.toSpliced()
    35. Array.prototype.toString()
    36. Array.prototype.unshift()
    37. Array.prototype.values()
    38. Array.prototype.with()
    39. Array.prototype[Symbol.iterator]()
  7. 实例属性
    1. Array：length
    2. Array.prototype[Symbol.unscopables]
  8. 继承
  9. Object/Function
  10. 静态方法
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. Function.prototype[Symbol.hasInstance]()
  11. 静态属性
    1. Function.displayName
    2. Function：length
    3. Function.name
    4. Function.prototype.prototype
    5. Function.prototype.arguments
    6. Function.prototype.caller
  12. 实例方法
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  13. 实例属性
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

构建更美好互联网的蓝图。

MDN 参与贡献 开发者

访问 Mozilla 公司的非营利母机构 Mozilla 基金会。
本内容的部分版权归 mozilla.org 贡献者所有，©1998–2026。内容依据知识共享许可协议提供。