Skip to content Skip to footer

JavaScript Array Replace: A Deep Dive into Swapping Elements Like a Pro

Hey there, fellow coders! Today, we’re going to slice and dice our way through the world of JavaScript arrays, specifically focusing on the art of replacing elements. Whether you’re just starting out or you’re a seasoned dev, you know that manipulating arrays is a fundamental skill in JavaScript. So let’s get our hands dirty and explore the various ways to perform an array replace operation.

The Classic splice() Method

Let’s kick things off with the old-school but ever-reliable splice() method. It’s like the Swiss Army knife for arrays – you can add, remove, and replace elements all in one go. Here’s how you can use it to replace elements in an array:

let myArray = ['apple', 'banana', 'cherry', 'date'];
myArray.splice(2, 1, 'blueberry'); // Replaces 'cherry' with 'blueberry'
console.log(myArray); // Output: ['apple', 'banana', 'blueberry', 'date']

In this snippet, the splice() method takes three parameters:

  1. The start index (2 in our case) – where to begin the changes.
  2. The delete count (1 here) – how many elements to remove.
  3. The item(s) to add (‘blueberry’) – the new element(s) to insert.

Simple, right? But what if you want to replace an element without knowing its exact index? Enter the findIndex() method.

Pairing splice() with findIndex()

Imagine you’re dealing with a larger array, and you need to replace an element based on a condition rather than a known index. Here’s how you can combine splice() with findIndex():

let myBigArray = ['apple', 'banana', 'cherry', 'date', 'elderberry', 'fig', 'grape'];
const fruitToReplace = 'date';
const replacementFruit = 'dragonfruit';

const index = myBigArray.findIndex(fruit => fruit === fruitToReplace);
if (index !== -1) {
  myBigArray.splice(index, 1, replacementFruit);

// Output: ['apple', 'banana', 'cherry', 'dragonfruit', 'elderberry', 'fig', 'grape']

In this example, findIndex() locates the index of the element we want to replace (‘date’), and then we use splice() to swap it out with ‘dragonfruit’. Neat and tidy!

Embracing Immutability with ES6 Spread Syntax

Now, for those of you who love functional programming and immutability, let’s talk about the ES6 spread syntax. It’s like a magic wand that lets you create a new array with all the old elements, plus any changes you want to make.

Here’s how you can replace an element in an array without mutating the original array:

const originalArray = ['apple', 'banana', 'cherry', 'date'];
const itemToReplace = 'cherry';
const newItem = 'cantaloupe';

const newArray = => item === itemToReplace ? newItem : item);

console.log(newArray); // Output: ['apple', 'banana', 'cantaloupe', 'date']
console.log(originalArray); // Output: ['apple', 'banana', 'cherry', 'date']

In the above code, we use map() to iterate over the original array. For each element, we check if it’s the one we want to replace. If it is, we return the new item; otherwise, we return the original item. This gives us a brand new array with the replacement made, and our original array stays untouched.

Leveraging Lodash for Convenience

Sometimes, you want to stand on the shoulders of giants, and that’s where Lodash, a utility library, comes into play. It offers a convenient _.replace() method that’s perfect for string replacement within an array.

Let’s see Lodash in action:

const _ = require('lodash');

let myStringArray = ['I like apples', 'Bananas are great', 'Cherries are fun'];
const stringToReplace = 'Cherries are fun';
const newString = 'Mangoes are magnificent';

let replacedArray =, str => _.replace(str, stringToReplace, newString));

// Output: ['I like apples', 'Bananas are great', 'Mangoes are magnificent']

In this example, we use to iterate over the array and _.replace() to swap out the string. It’s a bit of a different use case, as it’s more about replacing substrings within array elements, but it’s super handy when you need it.

Alright, we’ve covered some ground here, from the classic splice() to the wonders of Lodash. But wait, there’s more! We’ll dive into more advanced techniques and frameworks in the second half of this article. Stay tuned for the juicy bits on how to replace array elements like a JavaScript ninja!

Getting Functional with Ramda

If you’re into functional programming, you’ll love Ramda. This library is designed for a functional programming style, making it easy to create immutable data structures and pure functions. Let’s see how you can replace an element in an array with Ramda’s update function:

const R = require('ramda');

let numbers = [10, 20, 30, 40, 50];
const indexToReplace = 2;
const newValue = 35;

let newNumbers = R.update(indexToReplace, newValue, numbers);

console.log(newNumbers); // Output: [10, 20, 35, 40, 50]
console.log(numbers); // Output: [10, 20, 30, 40, 50] (remains unchanged)

With Ramda’s update function, you specify the index of the element you want to replace, the new value, and the original array. The function returns a new array with the replacement made, and the original array is left untouched. Functional and clean!

The Power of React’s State Hook for Array Replacement

When working with React, you often manage state in a way that avoids direct mutation. The state hook, useState, is a perfect match for this. Here’s how you can replace an array element in a React component:

import React, { useState } from 'react';

const FruitList = () => {
  const [fruits, setFruits] = useState(['apple', 'banana', 'cherry']);

  const replaceFruit = (oldFruit, newFruit) => {
    setFruits( => fruit === oldFruit ? newFruit : fruit));

  return (
        { => <li key={fruit}>{fruit}</li>)}
      <button onClick={() => replaceFruit('banana', 'blueberry')}>
        Replace Banana

export default FruitList;

In this React component, we’re using the useState hook to manage our fruit array. The replaceFruit function uses map to create a new array with the replacement made, and then we use setFruits to update the state. This triggers a re-render of the component with the updated array.

Vue’s Reactive Array Replacement

Vue.js also makes it straightforward to replace array elements in a reactive way. Vue’s reactivity system ensures that any changes to the array trigger updates in the DOM. Here’s an example using Vue 3’s Composition API:

      <li v-for="item in items" :key="item">{{ item }}</li>
    <button @click="replaceItem('pear', 'peach')">Replace Pear</button>

import { ref } from 'vue';

export default {
  setup() {
    const items = ref(['apple', 'banana', 'pear']);

    const replaceItem = (oldItem, newItem) => {
      const index = items.value.findIndex(item => item === oldItem);
      if (index !== -1) {
        items.value.splice(index, 1, newItem);

    return { items, replaceItem };

In this Vue component, we use the ref function to create a reactive reference for our array. The replaceItem method finds the index of the item to replace and uses splice to make the replacement. Vue’s reactivity system takes care of the rest, updating the DOM automatically.

Angular’s Immutable Array Replacement with RxJS

Angular often goes hand-in-hand with RxJS, a library for reactive programming using observables. Here’s how you might replace an element in an array within an Angular service:

import { BehaviorSubject } from 'rxjs';

export class FruitService {
  private fruitsSubject = new BehaviorSubject<string[]>(['apple', 'banana', 'cherry']);
  fruits$ = this.fruitsSubject.asObservable();

  replaceFruit(oldFruit: string, newFruit: string) {
    const fruits = this.fruitsSubject.getValue();
    const index = fruits.indexOf(oldFruit);
    if (index > -1) {
      const newFruits = [...fruits.slice(0, index), newFruit, ...fruits.slice(index + 1)];;

In this Angular service, we’re using a BehaviorSubject to hold our fruits array. The replaceFruit method creates a new array with the replacement and then pushes that new array into the stream using next. Components subscribing to fruits$ will receive the new array and update accordingly.

And there you have it! We’ve explored a plethora of ways to replace elements in JavaScript arrays, from the simplicity of splice() to the elegance of functional libraries and the reactivity of modern frameworks. Whether you’re tweaking your personal project or architecting a complex application, these patterns and tools will help you manipulate arrays with precision and style. Keep coding and keep sharing your knowledge, just like we do!