Class ScmAmendComponent

context

static contextType = MyContext
// For TS pre-3.7:
context!: React.ContextType<typeof MyContext>
// For TS 3.7 and above:
declare context: React.ContextType<typeof MyContext>
Copy

Readonlyprops

refs

state

Static OptionalcontextType

type MyContext = number
const Ctx = React.createContext<MyContext>(0)

class Foo extends React.Component {
  static contextType = Ctx
  context!: React.ContextType<typeof Ctx>
  render () {
    return <>My context's value: {this.context}</>;
  }
}
Copy

OptionalcomponentDidCatch

• componentDidCatch?(error: Error, errorInfo: ErrorInfo): void

  Catches exceptions generated in descendant components. Unhandled exceptions will cause the entire component tree to unmount.

  Parameters

  • error: Error
  • errorInfo: ErrorInfo

  Returns void

OptionalcomponentDidUpdate

• componentDidUpdate?(
      prevProps: Readonly<P>,
      prevState: Readonly<S>,
      snapshot?: any,
  ): void

  Called immediately after updating occurs. Not called for the initial render.

  The snapshot is only present if getSnapshotBeforeUpdate is present and returns non-null.

  Parameters

  • prevProps: Readonly<P>
  • prevState: Readonly<S>
  • Optionalsnapshot: any

  Returns void

OptionalcomponentWillMount

• componentWillMount?(): void

  Called immediately before mounting occurs, and before Component.render. Avoid introducing any side-effects or subscriptions in this method.

  Note: the presence of getSnapshotBeforeUpdate or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents this from being invoked.

  Returns void

  Deprecated

  16.3, use componentDidMount or the constructor instead; will stop working in React 17

  See

  • https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#initializing-state
  • https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#gradual-migration-path

OptionalcomponentWillReceiveProps

• componentWillReceiveProps?(nextProps: Readonly<P>, nextContext: any): void

  Called when the component may be receiving new props. React may call this even if props have not changed, so be sure to compare new and existing props if you only want to handle changes.

  Calling Component.setState generally does not trigger this method.

  Note: the presence of getSnapshotBeforeUpdate or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents this from being invoked.

  Parameters

  • nextProps: Readonly<P>
  • nextContext: any

  Returns void

  Deprecated

  16.3, use static StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps instead; will stop working in React 17

  See

  • https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#updating-state-based-on-props
  • https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#gradual-migration-path

OptionalcomponentWillUpdate

• componentWillUpdate?(
      nextProps: Readonly<P>,
      nextState: Readonly<S>,
      nextContext: any,
  ): void

  Called immediately before rendering when new props or state is received. Not called for the initial render.

  Note: You cannot call Component.setState here.

  Note: the presence of getSnapshotBeforeUpdate or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents this from being invoked.

  Parameters

  • nextProps: Readonly<P>
  • nextState: Readonly<S>
  • nextContext: any

  Returns void

  Deprecated

  16.3, use getSnapshotBeforeUpdate instead; will stop working in React 17

  See

  • https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#reading-dom-properties-before-an-update
  • https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#gradual-migration-path

forceUpdate

• forceUpdate(callback?: () => void): void

  Parameters

  • Optionalcallback: () => void

  Returns void

OptionalgetSnapshotBeforeUpdate

• getSnapshotBeforeUpdate?(prevProps: Readonly<P>, prevState: Readonly<S>): any

  Runs before React applies the result of render to the document, and returns an object to be given to componentDidUpdate. Useful for saving things such as scroll position before render causes changes to it.

  Note: the presence of this method prevents any of the deprecated lifecycle events from running.

  Parameters

  • prevProps: Readonly<P>
  • prevState: Readonly<S>

  Returns any

setState

• setState<K extends keyof ScmAmendComponentState>(
      state:
          | null
          | ScmAmendComponentState
          | (
              (
                  prevState: Readonly<S>,
                  props: Readonly<P>,
              ) => null | ScmAmendComponentState | Pick<ScmAmendComponentState, K>
          )
          | Pick<ScmAmendComponentState, K>,
      callback?: () => void,
  ): void

  We MUST keep setState() as a unified signature because it allows proper checking of the method return type. See: https://github.com/DefinitelyTyped/DefinitelyTyped/issues/18365#issuecomment-351013257 Also, the | S allows intellisense to not be dumbisense

  Type Parameters

  • K extends keyof ScmAmendComponentState

  Parameters

  • state:
        | null
        | ScmAmendComponentState
        | (
            (
                prevState: Readonly<S>,
                props: Readonly<P>,
            ) => null | ScmAmendComponentState | Pick<ScmAmendComponentState, K>
        )
        | Pick<ScmAmendComponentState, K>
  • Optionalcallback: () => void

  Returns void

OptionalshouldComponentUpdate

• shouldComponentUpdate?(
      nextProps: Readonly<P>,
      nextState: Readonly<S>,
      nextContext: any,
  ): boolean

  Called to determine whether the change in props and state should trigger a re-render.

  Component always returns true. PureComponent implements a shallow comparison on props and state and returns true if any props or states have changed.

  If false is returned, Component.render, componentWillUpdate and componentDidUpdate will not be called.

  Parameters

  • nextProps: Readonly<P>
  • nextState: Readonly<S>
  • nextContext: any

  Returns boolean

OptionalUNSAFE_componentWillMount

• UNSAFE_componentWillMount?(): void

  Called immediately before mounting occurs, and before Component.render. Avoid introducing any side-effects or subscriptions in this method.

  This method will not stop working in React 17.

  Note: the presence of getSnapshotBeforeUpdate or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents this from being invoked.

  Returns void

  Deprecated

  16.3, use componentDidMount or the constructor instead

  See

  • https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#initializing-state
  • https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#gradual-migration-path

OptionalUNSAFE_componentWillReceiveProps

• UNSAFE_componentWillReceiveProps?(
      nextProps: Readonly<P>,
      nextContext: any,
  ): void

  Called when the component may be receiving new props. React may call this even if props have not changed, so be sure to compare new and existing props if you only want to handle changes.

  Calling Component.setState generally does not trigger this method.

  This method will not stop working in React 17.

  Note: the presence of getSnapshotBeforeUpdate or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents this from being invoked.

  Parameters

  • nextProps: Readonly<P>
  • nextContext: any

  Returns void

  Deprecated

  16.3, use static StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps instead

  See

  • https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#updating-state-based-on-props
  • https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#gradual-migration-path

OptionalUNSAFE_componentWillUpdate

• UNSAFE_componentWillUpdate?(
      nextProps: Readonly<P>,
      nextState: Readonly<S>,
      nextContext: any,
  ): void

  Called immediately before rendering when new props or state is received. Not called for the initial render.

  Note: You cannot call Component.setState here.

  This method will not stop working in React 17.

  Note: the presence of getSnapshotBeforeUpdate or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents this from being invoked.

  Parameters

  • nextProps: Readonly<P>
  • nextState: Readonly<S>
  • nextContext: any

  Returns void

  Deprecated

  16.3, use getSnapshotBeforeUpdate instead

  See

  • https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#reading-dom-properties-before-an-update
  • https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#gradual-migration-path