# Using the CloudWatch RUM Web Client with React 17

## Add the snippet to index.html

To install the web client in a React application, add the snippet inside the \<head\> tag of `index.html`.

```html
<!doctype html>
<html lang="en">
<head>
  <script>
    (function(n,i,v,r,s,c,u,x,z){x=window.AwsRumClient={q:[],n:n,i:i,v:v,r:r,c:c,u:u};window[n]=function(c,p){x.q.push({c:c,p:p});};z=document.createElement('script');z.async=true;z.src=s;document.head.insertBefore(z,document.getElementsByTagName('script')[0]);})('cwr','00000000-0000-0000-0000-000000000000','1.0.0','us-west-2','https://client.rum.us-east-1.amazonaws.com/1.0.2/cwr.js',{sessionSampleRate:1,guestRoleArn:'arn:aws:iam::000000000000:role/RUM-Monitor-us-west-2-000000000000-0000000000000-Unauth',identityPoolId:'us-west-2:00000000-0000-0000-0000-000000000000',endpoint:'https://dataplane.rum.us-west-2.amazonaws.com',telemetries:['errors','http','performance'],allowCookies:true});
  </script>
  ...
</head>
<body>
  ...
</body>
```

## Instrument Routing to Record Page Views

If your application contains arguments in the URL's path, you likely want to
record custom page IDs so that the arguments can be removed and the pages will
be properly aggregated in CloudWatch. For example, if we have two URLs
`https://amazonaws.com/user/123` and `https://amazonaws.com/user/456`, we likely
want to remove the user ID from the path so that the page ID is `/user` for both
URLs.

For React applications, we can use a [React Router
hook](https://reactrouter.com/web/api/Hooks/uselocation) to record a custom page
ID:

```typescript
import { useLocation } from "react-router-dom";

declare function cwr(operation: string, payload: any): void;

const Container = () => {

  let location = useLocation();
  React.useEffect(() => {
    console.log(location.pathname);
    cwr("recordPageView", location.pathname);
  }, [location]);

  return (
    <div>
      {<MyComponent />}
    </div>
  );
};

export default Container;
```


## Instrument Error Handling to Record Errors

React intercepts uncaught JavaScript errors that originate within the React
application. Because React intercepts these errors, they will not be recorded by
the web client. This can be fixed by adding [error
boundaries](https://reactjs.org/blog/2017/07/26/error-handling-in-react-16.html)
that record uncaught errors using the web client's `recordError` command:

```typescript
declare function cwr(operation: string, payload: any): void;

class App extends Component {
...
  componentDidCatch(error, info) {
    console.log(error);
    cwr('recordError', error);
  };
...
}
```