jest-dynamodb-local-docker

Jest preset for easily running tests using DynamoDB local

Usage

See the tests in this repo for example usage.

Add to your Jest setup

Add the jest-dynamodb-local-docker preset to your Jest config. For example:

// in your package.json
{
  "jest": {
    "preset": "jest-dynamodb-local-docker"
  }
}

Globals

• global.createTable - Creates a DynamoDB table
• global.deleteTable - Deletes a DynamoDB table
• global.getDynamodbClient and global.getDynamodbDocumentClient - Get a standard DynamoDB Client or DynamoDB DocumentClient configured to use DynamoDB local

jest --runInBand

You may need to use the --runInBand configuration flag when running your Jest tests. Otherwise, you can have multiple test workers trying to create/delete the same tables concurrently, which will probably lead to unexpected results.

Alternatively, if you ensure that each test uses a unique table, you should be able to run without --runInBand.

Debugging

We use debug for debugging logs. To turn on the debugging logs, run your tests like:

DEBUG="jest-dynamodb-local-docker" jest --runInBand