---
title: "write(to:ofType:)"
framework: appkit
role: symbol
role_heading: Instance Method
path: "appkit/nsdocument/write(to:oftype:)"
---

# write(to:ofType:)

Writes the contents of the document to a file or file package located by a URL, that is formatted to a specified type.

## Declaration

```swift
nonisolated func write(to url: URL, ofType typeName: String) throws
```

## Parameters

- `url`: The location to which the document contents are written.
- `typeName`: The string that identifies the document type.

## Discussion

Discussion The default implementation of this method just invokes [self fileWrapperOfType:typeName error:outError] and writes the returned file wrapper to disk. For backward binary compatibility with OS X v10.3 and earlier, the default implementation of this method instead invokes [self writeToFile:[absoluteURL path] ofType:typeName] if writeToFile:ofType: is overridden and the URL uses the file: scheme. note: In Swift, this method is marked with the throws keyword to indicate that it throws an error in cases of failure. When overriding this method, use the throw statement to throw an NSError, as described in Error Handling in The Swift Programming Language and About Imported Cocoa Error Parameters.

## See Also

### Writing the Document’s Content

- [canAsynchronouslyWrite(to:ofType:for:)](appkit/nsdocument/canasynchronouslywrite(to:oftype:for:).md)
- [unblockUserInteraction()](appkit/nsdocument/unblockuserinteraction().md)
- [writeSafely(to:ofType:for:)](appkit/nsdocument/writesafely(to:oftype:for:).md)
- [fileWrapper(ofType:)](appkit/nsdocument/filewrapper(oftype:).md)
- [data(ofType:)](appkit/nsdocument/data(oftype:).md)
- [write(to:ofType:for:originalContentsURL:)](appkit/nsdocument/write(to:oftype:for:originalcontentsurl:).md)
- [save(to:ofType:for:delegate:didSave:contextInfo:)](appkit/nsdocument/save(to:oftype:for:delegate:didsave:contextinfo:).md)
- [save(to:ofType:for:completionHandler:)](appkit/nsdocument/save(to:oftype:for:completionhandler:).md)
- [fileAttributesToWrite(to:ofType:for:originalContentsURL:)](appkit/nsdocument/fileattributestowrite(to:oftype:for:originalcontentsurl:).md)
- [NSDocument.SaveOperationType](appkit/nsdocument/saveoperationtype.md)