Type Checking

Create Magento App Create ScandiPWA App User Manual GitHub
Search…
Type Checking
ScandiPWA uses PropTypes to help verify that the expected props are passed, and catch bugs
​PropTypes is a library for React that verifies at runtime if props have the correct type, and if required props are passed. 
PropTypes are only used in development builds, which means that production builds will be more efficient - but it also means that you should not rely on PropTypes being present in the production build!
PropTypes are declared as a static field:
component/CategoryPaginationLink/CategoryPaginationLink.component.js (annotated excerpt)
1
import { ChildrenType } from 'Type/Common';
2
​
3
export class CategoryPaginationLink extends PureComponent {
4
    static propTypes = {
5
        // component children are treated as props in React
6
        // by leaving out .isRequired, we make them optional
7
        children: ChildrenType,
8
        // we expect the getPage prop to be a function
9
        // it is required, so this will emit a warning if
10
        // getPage is not provided
11
        getPage: PropTypes.func.isRequired,
12
        // isCurrent expects a boolean
13
        isCurrent: PropTypes.bool.isRequired,
14
        // expects a string
15
        url_path: PropTypes.string.isRequired,
16
        // expects a number
17
        pageNumber: PropTypes.number.isRequired
18
    };
19
    
20
    static defaultProps = {
21
        // we must provide a default value for every prop that
22
        // is optionalex
23
        children: []
24
    };
Copied!
Advanced Types
Sometimes you want to specify that a prop expects something more complex than a number or a string. You can check the official documentation to learn how to use:
instanceOf to expect an instance of a class
oneOf to expect an enum-like value that can have one of the specified values
oneOfType to indicate that this prop may have one of the specified types
arrayOf or objectOf to specify that this prop is an array or object where each value has the specified type
shape or exact to specify that the prop should be an object, as well as what keys and values you expect it to have
For example, you could specify that a prop expecting a payment method should be given an object with two string properties:
1
PropTypes.shape({
2
    code: PropTypes.string,
3
    title: PropTypes.string
4
});
Copied!
However, it is likely that this "complex" type would be needed in multiple places in the application. Copy-pasting the same PropType definition would lead to code duplication, and a hard-to-maintain codebase. Instead, we prefer defining these types in the type directory and exporting them for re-use:
type/Checkout.js (excerpt)
1
import PropTypes from 'prop-types';
2
​
3
export const paymentMethodType = PropTypes.shape({
4
    code: PropTypes.string,
5
    title: PropTypes.string
6
});
Copied!
Now, we can use this type definition anywhere we want:
component/CheckoutPayment/CheckoutPayment.component.js (excerpt)
1
import { paymentMethodType } from 'Type/Checkout';
2
​
3
/** @namespace Component/CheckoutPayment/Component */
4
export class CheckoutPayment extends PureComponent {
5
    static propTypes = {
6
        method: paymentMethodType.isRequired,
7
        onClick: PropTypes.func.isRequired,
8
        isSelected: PropTypes.bool
9
    };
Copied!
The Util Directory
Next - Structure
Application assets
Last modified 1yr ago
Copy link
Contents
Advanced Types