Skip to content

The VT Augment widget is an official, compliant and recommended way of integrating VirusTotal data in third-party applications.

License

Notifications You must be signed in to change notification settings

VirusTotal/vt-augment

Repository files navigation

VT Augment logo

Client library that wraps common patterns when interacting with the VirusTotal Augment widget.


Table of Contents

Installation

npm i @virustotal/vt-augment --save

Usage

VT Augment is bundled using the UMD format (@dist/vt-augment.min.js).

<!--- "VTAugment" will be attached to the global window object. -->
<script src="./node_modules/@virustotal/vt-augment/dist/vt-augment.min.js"></script>

Code

<div id="vt-augment-container"></div>
const container = document.querySelector('#vt-augment-container');

const vtaugment = new VTAugment(container, options)

vtaugment.load("[url]").openDrawer()

Modes

Drawer

This is the default mode, VT Augment will be shown in a right side panel when the openDrawer method is called.

Standalone

This mode allows you to integrate the widget as a non-animated div in your page. See Options.

API

vtaugment(container = null, opts = {})

Creates a new object with a html element and a set of options. An iframe is dynamically created inside the container to host the VT API response.

Methods

Methods can be chained and can be called in whatever order.

load openDrawer closeDrawer loading

load(url: string)

Loads the VT API url into the iframe.

vtaugment.load("...")

// Additionally, if the mode is `drawer` can be used along with the method `openDrawer`

vtaugment.load("...").openDrawer()

openDrawer()

Open a drawer panel from the right side. (Only works in drawer mode)

vtaugment.openDrawer()

closeDrawer()

Close the drawer panel. (Only works in drawer mode)

vtaugment.closeDrawer()

loading(active: boolean)

The loading state is managed internally by the library but in the case of need the api provides this method to control loading manually. (Active loading hide the content)

vtaugment.loading(true)

Options

{
  // Background color for loading states. Default ''.
  background: '#fff',
  // Force to closing the widget only with the X button. Default true.
  closingFromOutside: true | false,
  // Select the widget mode. Default drawer.
  mode: 'drawer' | 'standalone',
}

About

The VT Augment widget is an official, compliant and recommended way of integrating VirusTotal data in third-party applications.

Resources

License

Stars

Watchers

Forks

Packages

No packages published