prop-types

prop-types is Facebook’s standalone runtime type-checking library for React component props, extracted from React core in 2017 so it could evolve independently of React’s release cycle and be reused by libraries beyond React itself.

It lets you declare the expected shape of a component’s props using composable validators (strings, numbers, shapes, arrays of a type, unions, and more), then warns in the console during development whenever a parent passes data that doesn’t match — without adding any overhead to production builds.

What You Get

• Primitive validators for array, bool, func, number, object, string, symbol, and bigint prop types.
• Composable validators like arrayOf, objectOf, shape, exact, oneOf, and oneOfType for structured or constrained data.
• React-aware validators for node, element, and elementType, covering anything renderable or component-like.
• A production-safe checkPropTypes() API for validating props manually outside of a component’s own propTypes.

Common Use Cases

• Documenting and enforcing the expected shape of props on shared or public React components.
• Catching integration bugs early in development when a parent passes the wrong data type to a child component.
• Validating props on plain JS objects using PropTypes.checkPropTypes() outside of React’s normal render cycle.

Under The Hood

Architecture - index.js branches on NODE_ENV to load one of two factories: factoryWithTypeCheckers.js (development) builds the full set of validator functions with warnings, while factoryWithThrowingShims.js (production) swaps in shims that are no-ops unless called directly, in which case they throw to prevent accidental production use. factory.js is a separate legacy-compat entry point that always returns the full type-checker factory regardless of environment, preserving behavior for old React versions (<=15.5) that expect validators to be callable directly. checkPropTypes.js implements the shared validation loop: it iterates a component’s typeSpecs, invokes each validator with a secret token (lib/ReactPropTypesSecret.js) that authorizes internal React calls while blocking direct end-user invocation, and memoizes each unique failure message in loggedTypeFailures so repeated renders don’t spam the console.

Tech Stack - Plain ES5 CommonJS JavaScript with no TypeScript and no ESM build. Three runtime dependencies: react-is (element/type detection), object-assign (an Object.assign ponyfill for older engines), and loose-envify (a transform that dead-code-eliminates the NODE_ENV branches during bundling). Dev tooling is Jest for tests, ESLint for linting, and Browserify plus UglifyJS for producing the CDN UMD bundles (prop-types.js / prop-types.min.js) — the npm-published CommonJS source itself ships unbundled.

Code Quality - The tests directory contains four large suites (PropTypesDevelopmentReact15.js, PropTypesDevelopmentStandalone-test.js, PropTypesProductionReact15-test.js, PropTypesProductionStandalone-test.js) totaling roughly 4,600 lines of tests against ~600 lines of source in factoryWithTypeCheckers.js — an unusually high test-to-source ratio that reflects the combinatorial surface of validator types crossed with required/optional and dev/prod/legacy variants. There’s no TypeScript and no formal error-code system, just hand-written message strings, but the codebase is small and single-purpose enough that this is a minor tradeoff. GitHub activity is low (last commit May 2024) — consistent with a stable, feature-complete primitive rather than an abandoned project.

API Design - Usage is zero-config: import PropTypes and assign validators to a component’s propTypes object. The chainable .isRequired modifier and composable builders (shape({…}), arrayOf(PropTypes.number), oneOfType([…])) read close to natural language, and failures are non-fatal, dev-only console warnings, deduplicated per message. Its one sharp edge — validators throw if called directly outside of checkPropTypes, a deliberate change from the old React.PropTypes gated by a secret token — is clearly documented in the README’s migration section.