@aws-sdk/client-textract-browser
Description
Amazon Textract detects and analyzes text in documents and converts it into machine-readable text. This is the API reference documentation for Amazon Textract.
Installing
To install the this package using NPM, simply type the following into a terminal window:
npm install @aws-sdk/client-textract-browser
Getting Started
Import
The AWS SDK is modulized by clients and commands in CommonJS modules. To send a request, you only need to import the client(TextractClient
) and the commands you need, for example AnalyzeDocumentCommand
:
//JavaScript
const {
TextractClient
} = require("@aws-sdk/client-textract-browser/TextractClient");
const {
AnalyzeDocumentCommand
} = require("@aws-sdk/client-textract-browser/commands/AnalyzeDocumentCommand");
//TypeScript
import { TextractClient } from "@aws-sdk/client-textract-browser/TextractClient";
import { AnalyzeDocumentCommand } from "@aws-sdk/client-textract-browser/commands/AnalyzeDocumentCommand";
Usage
To send a request, you:
- Initiate client with configuration (e.g. credentials, region). For more information you can refer to the API reference.
- Initiate command with input parameters.
- Call
send
operation on client with command object as input. - If you are using a custom http handler, you may call
destroy()
to close open connections.
const textract = new TextractClient({ region: "region" });
//clients can be shared by different commands
const params = {
Document: {
/**an object specifying Document*/
},
FeatureTypes: [
/**a list of string*/
]
};
const analyzeDocumentCommand = new AnalyzeDocumentCommand(params);
textract
.send(analyzeDocumentCommand)
.then(data => {
// do something
})
.catch(error => {
// error handling
});
In addition to using promises, there are 2 other ways to send a request:
// async/await
try {
const data = await textract.send(analyzeDocumentCommand);
// do something
} catch (error) {
// error handling
}
// callback
textract.send(analyzeDocumentCommand, (err, data) => {
//do something
});
The SDK can also send requests using the simplified callback style from version 2 of the SDK.
import * as AWS from "@aws-sdk/@aws-sdk/client-textract-browser/Textract";
const textract = new AWS.Textract({ region: "region" });
textract.analyzeDocument(params, (err, data) => {
//do something
});
Troubleshooting
When the service returns an exception, the error will include the exception information, as well as response metadata (e.g. request id).
try {
const data = await textract.send(analyzeDocumentCommand);
// do something
} catch (error) {
const metadata = error.$metadata;
console.log(
`requestId: ${metadata.requestId}
cfId: ${metadata.cfId}
extendedRequestId: ${metadata.extendedRequestId}`
);
/*
The keys within exceptions are also parsed. You can access them by specifying exception names:
if(error.name === 'SomeServiceException') {
const value = error.specialKeyInException;
}
*/
}
Getting Help
Please use these community resources for getting help. We use the GitHub issues for tracking bugs and feature requests and have limited bandwidth to address them.
- Ask a question on StackOverflow and tag it with
aws-sdk-js
- Come join the AWS JavaScript community on gitter
- If it turns out that you may have found a bug, please open an issue
Contributing
This client code is generated automatically. Any modifications will be overwritten the next time the `@aws-sdk/@aws-sdk/client-textract-browser' package is updated. To contribute to SDK you can checkout our code generator package.
License
This SDK is distributed under the Apache License, Version 2.0, see LICENSE for more information.