npm private modules

    truffle-test-utils

    0.1.0 • Public • Published

    truffle-test-utils

    Utils to support Truffle's JavaScript tests for Ethereum smart contracts.

    Install

    npm install truffle-test-utils
    

    How to use

    To use these helpers, include them at the top of your tests:

    require('truffle-test-utils').init();
    

    Utils

    Event testing

    Single event

    To make sure a smart contract call generates the expected event:

    // Regular call thanks to Truffle
    let result = await testedSmartContract.testedFunction();
    // Check event
    assert.web3Event(result, {
      event: 'TestedEvent',
      args: {
        param_1: 'Some value',
        param_2: 0x123456 // No need for toNumber hassle
      }
    }, 'The event is emitted');
    

    By omitting the args parameter, only the event itself is tested, no matter what its arguments are:

    let result = await testedSmartContract.testedFunction();
    assert.web3Event(result, {
      event: 'TestedEvent'
      // Any argument is allowed
    }, 'The event is emitted');
    

    So to make sure that an event has no arguments, pass an empty hash:

    let result = await testedSmartContract.testedFunction();
    assert.web3Event(result, {
      event: 'TestedEvent',
      args: {} // Event should have no argument at all
    }, 'The event is emitted');
    

    Note that assert.web3Event makes sure that a particular event is emitted. If other events are emitted too, they are simply ignored.

    Mutliple events

    You can check several events at once with assert.web3SomeEvents and assert.web3AllEvents.

    assert.web3SomeEvents checks the expected events and ignore additional events:

    let result = await testedSmartContract.testedFunction();
    assert.web3Events(result, [
      { event: 'E1' }, // testedFunction must emit E1
      { event: 'E2' }  // testedFunction must emit E2
       // What if testedFunction emits E3 too? It's okay
    ]);
    

    assert.web3AllEvents checks that the expected events are emitted and no others:

    let result = await testedSmartContract.testedFunction();
    assert.web3AllEvents(result, [
      { event: 'E1' }, // testedFunction must emit E1
      { event: 'E2' }  // testedFunction must emit E2
       // What if testedFunction emits E3 too? The test fails
    ]);
    

    assert.web3Events is an alias to assert.web3AllEvents.

    expect

    If you prefer expect, you can use it in place of assert:

    // Regular call thanks to Truffle
    let result = await testedSmartContract.testedFunction();
    // Check event
    expect.web3Event(result, {
      event: 'TestedEvent',
      args: {
        param_1: 'Some value',
        param_2: 0x123456 // No need for toNumber hassle
      }
    }, 'The event is emitted');
    

    Install

    npm i truffle-test-utils

    DownloadsWeekly Downloads

    108

    Version

    0.1.0

    License

    GPL-3.0

    Unpacked Size

    41.4 kB

    Total Files

    4

    Last publish

    Collaborators

    • chaintrust