Course contentsShow
← React
Lesson 303 of 2,3969. Class Components (Legacy Overview)Free lesson

getSnapshotBeforeUpdate: Reading DOM Before Update

Capturing information from the DOM before React commits changes, used with componentDidUpdate.

getSnapshotBeforeUpdate: Reading DOM Before Update

What You'll Learn

You'll learn how to capture information from the DOM right before React applies changes, allowing you to preserve measurements or positions that would otherwise be lost.

The Problem This Solves

Sometimes you need to measure something about the DOM before React updates it. For example, imagine a chat window where new messages arrive. You might want to know the scroll position before the new messages render, so you can decide whether to auto-scroll or keep the user's current position.

Analogy: It's like checking your car's odometer reading right before you start driving. You need that "before" snapshot to compare against the "after" reading.

How getSnapshotBeforeUpdate Works

This lifecycle method runs after React prepares the changes but before they're committed to the DOM. It's your last chance to read the current DOM state.

class ChatWindow extends React.Component {
  getSnapshotBeforeUpdate(prevProps, prevState) {
    // Capture scroll position before new messages render
    const chatBox = this.chatBoxRef.current;
    return chatBox.scrollHeight - chatBox.scrollTop;
  }

  componentDidUpdate(prevProps, prevState, snapshot) {
    // snapshot is the value returned from getSnapshotBeforeUpdate
    if (snapshot !== null) {
      const chatBox = this.chatBoxRef.current;
      // Use snapshot to adjust scroll position
      chatBox.scrollTop = chatBox.scrollHeight - snapshot;
    }
  }
}

Whatever you return from getSnapshotBeforeUpdate becomes the third parameter to componentDidUpdate. The two always work together.

When You'd Use This

Rare scenarios like preserving scroll positions, capturing element dimensions before layout shifts, or measuring DOM nodes before animations.

Key Takeaway: getSnapshotBeforeUpdate lets you read the DOM immediately before React commits changes, returning a value you can use in componentDidUpdate to respond to those measurements—a specialized tool for handling pre-update DOM state.