---
title: Handling initialization events
framework: mapkitjs
role: collectionGroup
role_heading: API Collection
path: mapkitjs/handling-initialization-events
---

# Handling initialization events

Respond to events that trigger when MapKit JS initializes.

## Overview

Overview Unless you wish to explicitly control initialization timing in JavaScript, use data-token instead of handling initialization events directly. See Loading the latest version of MapKit JS for more information. The mapkit object emits two events to indicate the success or failure of a configuration operation. The initialization process configures MapKit JS. In addition, there are two events indicate the success or failure of a batch of library loads.  |  |   |  |   |  |   |  |   |  |  MapKit JS invokes these events asynchronously upon success or failure of the initialization request. The example below shows a common use case: mapkit.init({ authorizationCallback: function(done) { done("your-token"); }, ... }); mapkit.addEventListener("configuration-change", function(event) {     switch (event.status) {     case "Initialized":         // MapKit JS initializes and configures.         break;     case "Refreshed":         // The MapKit JS configuration updates.         break;     } });

## Topics

### Events

- [MapKitConfigurationChangeEvent](mapkitjs/mapkitconfigurationchangeevent.md)
- [MapKitConfigurationErrorEvent](mapkitjs/mapkitconfigurationerrorevent.md)
- [MapKitLibraryLoadEvent](mapkitjs/mapkitlibraryloadevent.md)

### Initialization and error status

- [ConfigurationChangeStatus](mapkitjs/configurationchangestatus.md)
- [ConfigurationErrorStatus](mapkitjs/configurationerrorstatus.md)

## See Also

### Initialization

- [init(options)](mapkitjs/mapkit/init.md)
- [MapKitInitializationOptions](mapkitjs/mapkitinitializationoptions.md)
- [Libraries](mapkitjs/mapkit/libraries.md)
- [loadedLibraries](mapkitjs/mapkit/loadedlibraries.md)
- [load(libraryNames)](mapkitjs/mapkit/load.md)