Type Property


Returns whether the document subclass supports autosaving of drafts.


class var autosavesDrafts: Bool { get }

Return Value

true if the receiving subclass of NSDocument supports autosaving of drafts; otherwise false.


The system expects that an NSDocument subclass that returns true from this method can properly handle save operations that use the NSDocument.SaveOperationType.autosaveAsOperation save operation type.

The default implementation of this method returns true for apps linked on or after OS X v10.8, and returns no for apps linked against earlier versions of macOS.

To opt out of autosaving in your NSDocument subclass when linking on or after OS X v10.8, override this method to return false.

When linking against a macOS version prior to 10.8, you can declare that your NSDocument subclass supports autosaving by overriding this method to return true.

AppKit invokes this method at various times. For example, when the updateChangeCount(_:) method is called with NSDocument.ChangeType.changeDone but without the NSDocument.ChangeType.changeDiscardable change type, NSDocument will the next autosave to use NSDocument.SaveOperationType.autosaveAsOperation and return the document into a draft.

Do not invoke this method to find out whether autosaving of a draft will be done.

See Also

Configuring the Autosave Behavior

class var autosavesInPlace: Bool

Returns whether the receiver supports autosaving in place.

class var preservesVersions: Bool

Returns whether the document subclass supports version management.

var autosavedContentsFileURL: URL?

The location of the most recently autosaved document contents.

var autosavingFileType: String?

Returns the document type to use for an autosave operation.

var autosavingIsImplicitlyCancellable: Bool

Returns a Boolean value that indicates whether you can cancel an in-progress autosave operation.