[Home](./index.md) > [com-tools](./com-tools.md) > [array\_insertItem](./com-tools.array_insertitem.md) ## array\_insertItem() function insertItem(item, toIndex = 0, equalTest) 将指定元素插入到调用者数组中指定索引处，并且会删除调用者数组中与 item 相同的元素 **Signature:** ```typescript export declare function array_insertItem(array: T[], item: T, toIndex?: number, equalTest?: TestFun): T[]; ``` ## Parameters

Parameter	Type	Description
array	T\[\]
item	T	: any 被插入的元素
toIndex	number	_(Optional)_ : number 元素被插入到的位置的索引
equalTest	[TestFun](./com-tools.testfun.md)<T>	_(Optional)_ ? : (a,b)=>boolean 可选， 默认是通过全等 === 来判断元素是否相等的；测试数组元素是否相同的函数，返回 boolean 值，表示 元素a 和 元素b 相同；

**Returns:** T\[\] Array 被删除的元素