PullRequest
Represents a pull or merge request that is attached to an issue.
Extends AbstractVcsItem.
Properties
Name | Type | Description |
|---|---|---|
becomesRemoved | Boolean | Read-only. When `true`, the entity is removed in the current transaction. Otherwise, `false`. Available since 2017.4.37915 |
branch | String | Read-only. The name of the branch that the VCS change was committed to. Available since 2018.1.38923 |
fetched | Number | Read-only. The date when the pull request was retrieved from the VCS change processor. |
id | String | Read-only. A unique identifier. |
isNew | Boolean | Read-only. When `true`, the entity is created in the current transaction. Otherwise, `false`. Available since 2018.2.42351 |
previousState | PullRequestState | Read-only. The previous state of the pull request. Available since 2020.3 |
processor | ChangesProcessor | Read-only. The processor for VCS changes that transmitted information about the pull request. |
state | PullRequestState | Read-only. The state of the pull request. |
text | String | Read-only. The comment text that was included in the commit message. Available since 2018.1.38923 |
title | String | Read-only. The title of the pull request. |
user | User | Read-only. The user who authored the VCS change. Available since 2018.1.38923 |
userName | String | Read-only. The name of the change author, as returned by the VCS. Available since 2018.1.38923 |
Methods
becomes
Checks whether a field is set to an expected value in the current transaction.
Parameters
Name | Type | Description |
|---|---|---|
fieldName | string | The name of the field to check. |
expected | string | The expected value. |
Return Value
Type | Description |
|---|---|
boolean | If the field is set to the expected value, returns `true`. |
canBeReadBy
Checks whether a user has permission to read the field.
Parameters
Name | Type | Description |
|---|---|---|
fieldName | string | The name of the field. |
user | User | The user for whom the permission to read the field is checked. |
Return Value
Type | Description |
|---|---|
boolean | If the user can read the field, returns `true`. |
canBeWrittenBy
Checks whether a user has permission to update the field.
Parameters
Name | Type | Description |
|---|---|---|
fieldName | string | The name of the field. |
user | User | The user for whom the permission to update the field is checked. |
Return Value
Type | Description |
|---|---|
boolean | If the user can update the field, returns `true`. |
isChanged
Checks whether the value of a field is changed in the current transaction.
Parameters
Name | Type | Description |
|---|---|---|
fieldName | string | The name of the field to check. |
Return Value
Type | Description |
|---|---|
boolean | If the value of the field is changed in the current transaction, returns `true`. |
oldValue
Returns the previous value of a single-value field before an update was applied. If the field is not changed in the transaction, returns null.
Parameters
Name | Type | Description |
|---|---|---|
fieldName | string | The name of the field. |
Return Value
Type | Description |
|---|---|
Object | If the field is changed in the current transaction, the previous value of the field. Otherwise, null. |
required
Asserts that a value is set for a field. If a value for the required field is not set, the specified message is displayed in the user interface.
Parameters
Name | Type | Description |
|---|---|---|
fieldName | string | The name of the field to check. |
message | string | The message that is displayed to the user that describes the field requirement. |