# TrackedChange Object

> A TrackedChange object represents a change made to the document after anyone has revised the document. After tracking changes has been turned on with the setIsTrackChangesEnabled method, a TextControl marks up new changes made to the document. Every change is represented through a TrackedChange object, all of these objects are contained in the TrackedChangeCollection which can be obtained with the trackedChanges property.

- **Product:** TX Text Control .NET Server
- **Section:** Reference
- **Kind:** Object
- **Introduced:** 28.0
- **Path:** TX Text Control .NET Server > Reference > JavaScript API > TrackedChange Object
- **1185 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/llms-full.txt

---

### Description

A TrackedChange object represents a change made to the document after anyone has revised the document. After tracking changes has been turned on with the [setIsTrackChangesEnabled](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/txtextcontrol/setistrackchangesenabled-method/llms-full.txt) method, a TextControl marks up new changes made to the document. Every change is represented through a TrackedChange object, all of these objects are contained in the [TrackedChangeCollection](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchangecollection/llms-full.txt) which can be obtained with the [trackedChanges](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/formattedtext/trackedchanges-property/llms-full.txt) property.

### Syntax

```javascript
TrackedChange
```

### Examples

The following example demonstrates `TrackedChange` in a practical document-editing workflow. A TrackedChange object represents a change made to the document after anyone has revised the document. After tracking changes has been turned on with the setIsTrackChangesEnabled method, a TextControl marks up new changes made to the document. Every change is represented through a TrackedChange object, all of these objects are contained in the TrackedChangeCollection which can be obtained with the trackedChanges property.

```javascript
function onTxError(error) {
    console.error("TX Text Control error:", error.msg);
    error.handled = true;
}

TXTextControl.textParts.getMainText(function(mainText) {
    const trackedChanges = mainText.trackedChanges;
    trackedChanges.getItem(function(trackedChange) {
        if (!trackedChange) {
            console.warn("No tracked change is available at the current input position.");
            return;
        }
    
        trackedChange.getText(
            function(result) {
                console.log("get text result:", result);
            },
            onTxError
        );
    }, onTxError);
}, onTxError);
```

---

## In This Section

- [Javascript: TrackedChange.getActive Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/getactive-method/llms-full.txt): Gets a value specifying whether the TrackedChange is currently active or not.
- [Javascript: TrackedChange.getChangeKind Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/getchangekind-method/llms-full.txt): Gets the kind of change.
- [Javascript: TrackedChange.getChangeTime Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/getchangetime-method/llms-full.txt): Gets the date and time when the change has been made.
- [Javascript: TrackedChange.getHighlightColor Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/gethighlightcolor-method/llms-full.txt): Gets the highlight color for the tracked change.
- [Javascript: TrackedChange.getHighlightMode Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/gethighlightmode-method/llms-full.txt): Gets a value indicating whether the tracked change is highlighted.
- [Javascript: TrackedChange.getLength Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/getlength-method/llms-full.txt): Gets the number of changed characters.
- [Javascript: TrackedChange.getNumber Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/getnumber-method/llms-full.txt): Gets the change's number.
- [Javascript: TrackedChange.getStart Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/getstart-method/llms-full.txt): Gets the index (one-based) of the first changed character.
- [Javascript: TrackedChange.getText Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/gettext-method/llms-full.txt): Gets the changed text.
- [Javascript: TrackedChange.getUserName Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/getusername-method/llms-full.txt): Gets the name of the user who has done the change.
- [Javascript: TrackedChange.save Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/save-method/llms-full.txt): Saves the tracked change in a certain format and sends the result back asynchronously by calling a given callback function.
- [Javascript: TrackedChange.setActive Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/setactive-method/llms-full.txt): Sets a value specifying whether the TrackedChange is currently active or not.
- [Javascript: TrackedChange.setHighlightColor Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/sethighlightcolor-method/llms-full.txt): Sets the highlight color for the tracked change.
- [Javascript: TrackedChange.setHighlightMode Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/sethighlightmode-method/llms-full.txt): Sets a value indicating whether the tracked change is highlighted.

---

## Nearby

- **Previous:** [Javascript: TextViewLocationChangedEventArgs.location Property](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/textviewlocationchangedeventargs/location-property/llms-full.txt)
- **Next:** [Javascript: TrackedChange.getActive Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/trackedchange/getactive-method/llms-full.txt)