We want to hear from you!Take our 2021 Community Survey!
This site is no longer updated.Go to react.dev

嚴格模式

這些文檔很舊,不會更新。 前往 react.dev 獲取新的 React 文檔。

這些新的文件頁面教導 modern React 並包括即時範例:

嚴格模式 是一個用來突顯應用程式裡潛在問題的工具。如同 Fragment 一樣,嚴格模式 不會 render 任何可見的 UI。它為了底下的所有的依賴們啟動了額外的檢查和警告。

注意:

嚴格模式檢查只會在開發模式中執行;它們不應該影響正式環境

你可以在應用程式的任何地方打開嚴格模式。例如:

import React from 'react';

function ExampleApplication() {
  return (
    <div>
      <Header />
      <React.StrictMode>        <div>
          <ComponentOne />
          <ComponentTwo />
        </div>
      </React.StrictMode>      <Footer />
    </div>
  );
}

在上面的範例裡,嚴格模式檢查將不會跑在 HeaderFooter 元件上。然而 ComponentOneComponentTwo,以及它們底下的所有子依賴,都會被檢查。

StrictMode 目前可以幫助:

其他功能會在未來版本的 React 釋出時被加進去。

發現不安全的生命週期

這篇文章所述,某些遺留的生命週期在非同步的 React 應用程式裡使用是不安全的。然而,如果你的應用程式使用到第三方套件,確認這些生命週期有沒有被使用到是很困難的。幸好嚴格模式可以在這點幫助我們!

當嚴格模式被打開的時候,React 編譯了一整串用到這些不安全生命週期的 class component,然後記錄了這些 component 的警告訊息,例如:

strict mode unsafe lifecycles warning

現在 就關注這些被嚴格模式所發現的問題,會幫助你在 React 將來的版本裡處理非同步 render 的時候更容易。

警告使用到了 legacy string ref API

以前 React 提供了兩種管理 ref 的方式:legacy string ref API 和 callback API。雖然 string ref API 在兩者之間是比較方便的,但它有很多缺點,所以我們的官方推薦是使用 callback form.

React 16.3 加上了第三種選擇,提供了 string ref 的便利性且免除了那些缺點:

class MyComponent extends React.Component {
  constructor(props) {
    super(props);

    this.inputRef = React.createRef();  }

  render() {
    return <input type="text" ref={this.inputRef} />;  }

  componentDidMount() {
    this.inputRef.current.focus();  }
}

因為 object ref 已經大量取代了 string ref,嚴格模式現在會在你使用 string ref 的時候警告你。

注意:

除了新的 createRef API 以外,callback ref 會持續被支援。

你不需要改掉你 component 裡的 callback ref。它們稍微更有彈性,所以它們會持續是一個進階性的功能。

學習更多關於新的 createRef API。

警告使用到了被棄用的 findDOMNode

React 過去支援了 findDOMNode 來用 class instance 搜尋 tree 裡面的 DOM 節點。通常你不需要這個,因為你可以 直接把一個 ref 附到你的 DOM 節點

findDOMNode 也可以被使用在 class component 上,但這是一個破壞抽象層的用法,它允許了 parent 來要求 render 某個特定的 children。它產生了重構的風險,因為 parent 可能會進入到某個 DOM 節點,所以你不能隨意改變 component 的實作細節。findDOMNode 只會回傳第一個 child,但如果使用了 Fragment,有可能某個 component 會 render 多個 DOM 節點。findDOMNode 是一個只能讀一次的 API。它只在你要求的時候告訴你答案。如果一個 child component render 了不同的節點,沒有任何方法可以處理這樣的改變。所以 findDOMNode 只在元件永遠回傳一個單一且永遠不改變的 DOM 節點時有用。

你可以藉由傳遞 ref 到你的客製化 component,且把它傳到使用 ref forwarding 的 DOM,使它變得明顯。

你也可以在你的 component 加上一個包裹的 DOM 節點,然後把 ref 直接附在它上面。

class MyComponent extends React.Component {
  constructor(props) {
    super(props);
    this.wrapper = React.createRef();  }
  render() {
    return <div ref={this.wrapper}>{this.props.children}</div>;  }
}

注意:

在 CSS 裡,如果你不想要某個節點成為 layout 的一部份,display: contents attribute 可以被使用。

偵測意想不到的副作用

概念上,React 在兩種面相上能夠運作:

  • render 面相決定了必須做出什麼改變到例如 DOM 的地方。在這個面相上,React 呼叫 render 然後比較了它與上一次 render 的結果。
  • commit 面相是每當 React 運用到任何改變的時候。(在 React DOM 的例子,當 React 插入、更新、或移除 DOM 節點。)React 也在這個面相上呼叫了像是 componentDidMountcomponentDidUpdate 的生命週期。

Commit 面相通常非常快,但 render 可能會很慢。為了這個原因,將來的非同步模式(還沒被預設成開啟)會把 render 的工作切成小塊,暫停和恢復這些工作藉以避免阻擋瀏覽器。 這表示 React 可能會在 commit 之前調用多次 render 面相的生命週期,或是他會不管有沒有 commit 就調用它們(因為錯誤或是更高優先性的中斷)。

Render 面相的生命週期包含了以下 class component 函式:

  • constructor
  • componentWillMount(或 UNSAFE_componentWillMount
  • componentWillReceiveProps(或 UNSAFE_componentWillReceiveProps
  • componentWillUpdate(或 UNSAFE_componentWillUpdate
  • getDerivedStateFromProps
  • shouldComponentUpdate
  • render
  • setState updater functions (第一個參數)

因為以上函式可能會被呼叫不只一次,不包含副作用是很重要的。忽視這個規則可能會導致各種問題,包含記憶體滲漏,和不合法的應用程式 state。不幸的是,偵測這些問題很困難,因為它們通常是 non-deterministic

嚴格模式無法自動檢測 side effect,但它可以藉由使這些 side effect 變得更有確定性,來幫助你發現它們。它藉由故意調用兩次下面的函式來完成這個功能:

  • Class component constructorrendershouldComponentUpdate 方法
  • Class component 的靜態 getDerivedStateFromProps 方法
  • Function component 的內容
  • 狀態更新函式(setState 的第一個參數)
  • 函數傳遞至 useStateuseMemouseReducer

注意:

這個只在開發模式發生。生命週期不會被重複調用在正式環境。

例如,考慮以下程式碼:

class TopLevelRoute extends React.Component {
  constructor(props) {
    super(props);

    SharedApplicationState.recordEvent('ExampleComponent');
  }
}

第一眼看這段程式碼,可能不會覺得它有問題。但如果 SharedApplicationState.recordEvent 不是 idempotent 的話,多次實體化這個 component 可能會導致不合法的應用程式 state。這種細微的錯誤可能在開發期間不會出現,或者會不一致地出現,因此被忽略了。

通過有意地雙重調用如 component constructor,嚴格模式使這種模式更容易被發現。

注意:

從 React 17 開始,React 會自動更改如 console.log() 的 console 方法,以在第二次調用生命週期函數時使 log 靜音,在某些情況下,它可能會導致無法預期的行為,你可以使用替代方案

從 React 18 開始,React 不會抑制任何 log。然而,如果你有安裝 React DevTools,則第二次呼叫時會顯得有些黯淡。React DevTools 也提供了一個設定(預設關閉)來完全抑制它們。

檢測 legacy context API

Legacy context API 是容易出錯的,並將在以後的主要版本中刪除。它仍然適用於所有 16.x 版本,但將在嚴格模式下顯示以下警告訊息:

warn legacy context in strict mode

閱讀新的 context API 文件,以助於遷移到新版本。

Ensuring reusable state

In the future, we’d like to add a feature that allows React to add and remove sections of the UI while preserving state. For example, when a user tabs away from a screen and back, React should be able to immediately show the previous screen. To do this, React will support remounting trees using the same component state used before unmounting.

This feature will give React better performance out-of-the-box, but requires components to be resilient to effects being mounted and destroyed multiple times. Most effects will work without any changes, but some effects do not properly clean up subscriptions in the destroy callback, or implicitly assume they are only mounted or destroyed once.

To help surface these issues, React 18 introduces a new development-only check to Strict Mode. This new check will automatically unmount and remount every component, whenever a component mounts for the first time, restoring the previous state on the second mount.

To demonstrate the development behavior you’ll see in Strict Mode with this feature, consider what happens when React mounts a new component. Without this change, when a component mounts, React creates the effects:

* React mounts the component.
  * Layout effects are created.
  * Effects are created.

With Strict Mode starting in React 18, whenever a component mounts in development, React will simulate immediately unmounting and remounting the component:

* React mounts the component.
    * Layout effects are created.
    * Effects are created.
* React simulates effects being destroyed on a mounted component.
    * Layout effects are destroyed.
    * Effects are destroyed.
* React simulates effects being re-created on a mounted component.
    * Layout effects are created
    * Effect setup code runs

On the second mount, React will restore the state from the first mount. This feature simulates user behavior such as a user tabbing away from a screen and back, ensuring that code will properly handle state restoration.

When the component unmounts, effects are destroyed as normal:

* React unmounts the component.
  * Layout effects are destroyed.
  * Effects are destroyed.

Unmounting and remounting includes:

  • componentDidMount
  • componentWillUnmount
  • useEffect
  • useLayoutEffect
  • useInsertionEffect

Note:

This only applies to development mode, production behavior is unchanged.

For help supporting common issues, see:

Is this page useful?Edit this page