Chapter 1: Getting Started

Chapter 2: Using Atom

Chapter 3: Hacking Atom

Chapter 4: Behind Atom

Reference: API

Appendix A: Resources

Appendix B: FAQ

Appendix C: Shadow DOM

Appendix D: Upgrading to 1.0 APIs

Appendix E: Atom server-side APIs

CompositeDisposable Essential

An object that aggregates multiple Disposable instances together into a single disposable, so they can all be disposed as a group.

These are very useful when subscribing to multiple events.

Examples

[CompositeDisposable](../CompositeDisposable/) = require 'atom'

class Something
  constructor: ->
    @disposables = new CompositeDisposable
    editor = atom.workspace.getActiveTextEditor()
    @disposables.add editor.onDidChange ->
    @disposables.add editor.onDidChangePath ->

  destroy: ->
    @disposables.dispose()

Construction and Destruction

::constructor()

Construct an instance, optionally with one or more disposables

::dispose()

Dispose all disposables added to this composite disposable.

If this object has already been disposed, this method has no effect.

Managing Disposables

::add(disposable)

Add a disposable to be disposed when the composite is disposed.

If this object has already been disposed, this method has no effect.

Argument Description

disposable

Disposable instance or any object with a .dispose() method.

::remove(disposable)

Remove a previously added disposable.

Argument Description

disposable

Disposable instance or any object with a .dispose() method.

::clear()

Clear all disposables. They will not be disposed by the next call to dispose.