解決React報錯Property 'X' does not exist on type 'HTMLElement'

更新時間：2022年12月05日 10:27:47 作者：Borislav Hadzhiev

這篇文章主要為大家介紹了解決React報錯Property 'X' does not exist on type 'HTMLElement'，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪

總覽

在React中，當(dāng)我們試圖訪問類型為HTMLElement 的元素上不存在的屬性時，就會發(fā)生Property 'X' does not exist on type 'HTMLElement'錯誤。為了解決該錯誤，在訪問屬性之前，使用類型斷言來正確地類型聲明元素。

這里有三個例子來展示錯誤是如何發(fā)生的。

// App.tsx
import {useEffect} from 'react';
export default function App() {
  useEffect(() => {
    const input = document.getElementById('first_name');
    // ?? Property 'value' does not exist on type 'HTMLElement'.ts(2339)
    console.log(input?.value);
    // -----------------------------------------------------------------
    const link = document.getElementById('link');
    // ?? Property 'href' does not exist on type 'HTMLElement'.ts(2339)
    console.log(link?.href);
    // -----------------------------------------------------------------
    const button = document.getElementById('btn');
    if (button != null) {
      // ?? Property 'disabled' does not exist on type 'HTMLElement'.ts(2339)
      button.disabled = true;
    }
  }, []);
  return (
    <div>
      <input
        id="first_name"
        type="text"
        name="first_name"
        defaultValue="Initial Value"
      />
      <a id="link" href="<https://google.com>" rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  target="_blank" rel="noreferrer">
        Open Google
      </a>
      <button id="btn">Submit</button>
    </div>
  );
}

產(chǎn)生錯誤的原因是，document.getElementById方法的返回類型是HTMLElement | null，但是我們試圖訪問的屬性不存在于HTMLElement 類型。

類型斷言

為了解決這個錯誤，使用類型斷言來為元素正確地進(jìn)行類型聲明。比如說，類型斷言為HTMLInputElement, HTMLButtonElement, HTMLAnchorElement, HTMLImageElement, HTMLDivElement, HTMLTextAreaElement等等。這取決于你所處理的元素。

這些類型始終命名為HTML***Element 。一旦你開始輸入HTML…，你的IDE將會幫你自動補(bǔ)全。

import {useEffect} from 'react';
export default function App() {
  useEffect(() => {
    // ? type elements correctly via type assertions
    const input = document.getElementById('first_name') as HTMLInputElement;
    console.log(input?.value);
    const link = document.getElementById('link') as HTMLAnchorElement;
    console.log(link?.href);
    const button = document.getElementById('btn') as HTMLButtonElement;
    if (button != null) {
      button.disabled = true;
    }
  }, []);
  return (
    <div>
      <input
        id="first_name"
        type="text"
        name="first_name"
        defaultValue="Initial Value"
      />
      <a id="link" href="<https://google.com>" rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  target="_blank" rel="noreferrer">
        Open Google
      </a>
      <button id="btn">Submit</button>
    </div>
  );
}

類型斷言被用于我們知道值的類型信息，但是TypeScript卻不知道的時候。

我們明確的告訴TypeScript，input變量上存儲了HTMLInputElement ，并讓TS不要擔(dān)心。

同樣的，我們將link變量類型聲明為HTMLAnchorElement，將btn變量類型聲明為HTMLButtonElement 。

你可以在訪問一個屬性之前，內(nèi)聯(lián)使用類型斷言。

import {useEffect} from 'react';
export default function App() {
  useEffect(() => {
    const value = (document.getElementById('first_name') as HTMLInputElement).value;
    console.log(value);
  }, []);
  return (
    <div>
      <input
        id="first_name"
        type="text"
        name="first_name"
        defaultValue="Initial Value"
      />
      <a id="link" href="<https://google.com>" rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  target="_blank" rel="noreferrer">
        Open Google
      </a>
      <button id="btn">Submit</button>
    </div>
  );
}

如果你只需要訪問屬性一次，并且不希望將元素分配給變量，那么內(nèi)聯(lián)類型聲明可以完成這項(xiàng)工作。

如果你想更精確地處理元素的類型，可以使用聯(lián)合類型將類型聲明為HTML***Element | null 。

import {useEffect} from 'react';
export default function App() {
  useEffect(() => {
    const input = document.getElementById(
      'first_name',
    ) as HTMLInputElement | null;
    console.log(input?.value);
    const link = document.getElementById('link') as HTMLAnchorElement | null;
    console.log(link?.href);
    const button = document.getElementById('btn') as HTMLButtonElement | null;
    if (button != null) {
      button.disabled = true;
    }
  }, []);
  return (
    <div>
      <input
        id="first_name"
        type="text"
        name="first_name"
        defaultValue="Initial Value"
      />
      <a id="link" href="<https://google.com>" rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  rel="external nofollow"  target="_blank" rel="noreferrer">
        Open Google
      </a>
      <button id="btn">Submit</button>
    </div>
  );
}

HTML***Element 或者null 類型是最準(zhǔn)確的類型，因?yàn)槿绻鸇OM元素上不存在id屬性，那么document.getElementById()將會返回null。

你可以使用可選鏈操作符(?.)在訪問屬性之前來進(jìn)行短路運(yùn)算，如果引用是空值（null或者undefined）的話。

或者，你可以使用簡單的if語句作為類型守衛(wèi)，就像我們對button處理的那樣。