Example: Stream Locations

cwmsjs v2.4.0-2026.3.16

An example for calling the Stream Locations endpoint via CDA in JavaScript

Groundwork-Water + React

Checkout Groundwork-Water Hooks
The data components library for USACE made in React + Groundwork

Hooks are made wrapping CWMSjs using code similar to the React example below.
They also provide variables for you to track the state, progress, and data of the request.
The header on the Groundwork-Water webpage provides a list of currently available hooks.

React + Vite Example

To Install: npm install cwmsjs --save

import { Configuration, StreamLocationsApi } from "cwmsjs";


const config = new Configuration({
    basePath: 'https://cwms-data.usace.army.mil/cwms-data',
});
const stream_locations_api = new StreamLocationsApi(config);

stream_locations_api
    .getStreamLocations({
        officeMask: 'SWT',
        nameMask: 'KEYS*',
    })
    .then(async (data) => {
        expect(Array.isArray(data)).toBe(true);

        console.log(`Returned ${data.length} stream locations`);
    })
    .catch(async (e) => {
        if (e.response) {
            const error_msg = e.response.json();
            e.message = `${e.response.url}\n${e.message}\n${JSON.stringify(
                error_msg,
                null,
                2
            )}`;
            console.error(e);
            throw e;
        } else {
            throw e;
        }
    });

Bundle / Vanilla JS Example

To Install:

Run
curl -O "https://raw.githubusercontent.com/HydrologicEngineeringCenter/cwms-data-api-client-javascript/main/src/dist/bundle.js"
to download bundle.js to your system
Copy bundle.js to your web directory if not in that directory already

<!-- Include the bundle.js file -->
<script src="./bundle.js"></script>
<!-- Call the cwmsjs after the bundle has loaded -->
<script type="module">
const config = new cwmsjs.Configuration({
    basePath: 'https://cwms-data.usace.army.mil/cwms-data',
});
const stream_locations_api = new cwmsjs.StreamLocationsApi(config);

stream_locations_api
    .getStreamLocations({
        officeMask: 'SWT',
        nameMask: 'KEYS*',
    })
    .then(async (data) => {
        expect(Array.isArray(data)).toBe(true);

        console.log(`Returned ${data.length} stream locations`);
    })
    .catch(async (e) => {
        if (e.response) {
            const error_msg = e.response.json();
            e.message = `${e.response.url}\n${e.message}\n${JSON.stringify(
                error_msg,
                null,
                2
            )}`;
            console.error(e);
            throw e;
        } else {
            throw e;
        }
    });

</script>