Please review the IAB Tech Lab Open Source Initiative Governance guidelines here for contributing to this project.

IAB Tech Lab VAST Tester

Tests IAB VAST ads. Contributed by the DoubleVerify team.

This tool is also hosted by IAB Tech Lab at vasttester.iabtechlab.com.

Getting Started

Install dependencies:

yarn

Get developing:

yarn start

Create a production build:

yarn run build

Architecture

This is a React app bootstrapped with Create React App. All state is maintained using Redux. Side effects of state mutation are modeled using redux-observable.

There are subdirectories for the standard React-Redux model:

components/: React components (without Redux);
containers/: React components connected to Redux's store;
actions/: Redux action definitions;
reducers/: Redux reducers;
epics/: epics for redux-observable;
middleware/: Redux middleware.

In addition to those, there are also:

util/: various utility modules;
style/: Sass style sheets for the app.

More detailed documentation will be added at a later stage. For now, we suggest exploring the source code.

Debugging

During development, you can use:

React DevTools for React's DOM;
Redux DevTools for Redux actions and redux-observable effects;
Logger for Redux by setting localStorage.reduxLogger to true;

To Do

OM SDK in-app support
Resize support
Canned test scenarios
Reporting and recommendations
VAST validation

Contributing

We welcome pull requests for bug fixes and new features.

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.