Conversation
anselrognlie
left a comment
There was a problem hiding this comment.
Looks good! Please review my comments, and let me know if you have any questions. Nice job!
| return ( | ||
| <div id="App"> | ||
| <header> | ||
| <h1>Application title</h1> |
There was a problem hiding this comment.
It would be nice to update this to at least a hard-coded representation of the conversation title:
<h1>Chat between Vladimir and Estragon</h1>
| <p className="entry-time">Replace with TimeStamp component</p> | ||
| <button className="like">🤍</button> | ||
| <p>{props.body}</p> | ||
| <p className="entry-time"><TimeStamp time={props.timeStamp}></TimeStamp></p> |
There was a problem hiding this comment.
Nice use of the supplied TimeStamp. We pass in the timeStamp string from the message data and it takes care of the rest. All we had to do was confirm the name and type of the prop it was expecting (which we could do through its PropTypes) and we're all set!
Note that for components that don't expect to be given child markup, rather than explicitly writing the closing tag <TimeStamp></TimeStamp>, we prefer to use the empty tag shorthand <TimeStamp />.
| body: PropTypes.string.isRequired, | ||
| timeStamp: PropTypes.string.isRequired, | ||
| liked: PropTypes.bool.isRequired, | ||
| onHeart: PropTypes.func.isRequired, |
There was a problem hiding this comment.
The id, sender, body, timeStamp, and liked props are always passed (they're defined explicitly in the data and also provided in the test) so we can (and should) mark them isRequired.
The remaining props were up to you, and the tests don't know about them. As a result, using isRequired causes a warning when running any tests that only pass the known props. If you didn't see those warnings when running the tests, be sure to also try running the terminal npm test since the warnings are more visible.
To properly mark any other props isRequired, we would also need to update the tests to include at least dummy values (such as an empty callback () => {} for the like handler) to make the proptype checking happy.
Alternatively, for any props that we leave not required, we should also have logic in our component to not try to use the value if it's undefined.
| entries: PropTypes.arrayOf(PropTypes.shape({ | ||
| id: PropTypes.number.isRequired, | ||
| sender: PropTypes.string.isRequired, | ||
| body: PropTypes.string.isRequired, | ||
| timeStamp: PropTypes.string.isRequired, | ||
| liked: PropTypes.bool.isRequired, | ||
| })).isRequired, | ||
| onHeart: PropTypes.func.isRequired, |
There was a problem hiding this comment.
Similar to the props for ChatEntry, here, the entries prop is included in the tests, but the like toggle is not, resulting in prop warnings (unless we update the tests to reflect our custom props).
Again, if we were to leave this as not required so as to avoid the test warnings, we'd want to be sure that all the script logic in our component worked properly even in the absence of this value.
| const ChatLog = (props) => { | ||
| return ( | ||
| props.entries.map(entry => | ||
| <ChatEntry key={entry.id} id={entry.id} sender={entry.sender} body={entry.body} liked={entry.liked} timeStamp= {entry.timeStamp} |
There was a problem hiding this comment.
We should still aim for lines about 80 columns wide, even when not governed by a recommendation like Python's PEP8. And when our components don't accept nested components (when the tag content body is empty), prefer to omit the closing tag and use the self closing tag syntax (e.g., <MyComponent/> rather than <MyComponent></MyComponent>).
<ChatEntry
key={entry.id}
id={entry.id}
sender={entry.sender}
body={entry.body}
liked={entry.liked}
timeStamp={entry.timeStamp}
onHeart={props.onHeart}
/>
|
|
||
| const ChatEntry = (props) => { | ||
| // const [heart, setHeart] = useState(props.liked); | ||
| let heartShown = props.liked ? '❤️' : '🤍'; |
There was a problem hiding this comment.
👍 Nice use of a local variable to store the emoji picked using a ternary. Consider moving even something small like this to a helper function external to the component, so that the behavior of the emoji-picking logic can be tested easily outside of React.
| <p>{props.body}</p> | ||
| <p className="entry-time"><TimeStamp time={props.timeStamp}></TimeStamp></p> | ||
| {/* <button className="like" onClick={() => setHeart(!heart)}>{heartShown}</button> */} | ||
| <button className="like" onClick={() => props.onHeart(props.id)}>{heartShown}</button> |
There was a problem hiding this comment.
👍 Passing the id of this message lets the logic defined up in the App find the message to update in its data.
| const update = messages.map(message => { | ||
| if (message.id === id) { | ||
| return { ...message, liked: !message.liked}; | ||
| } | ||
| return message; | ||
| }); | ||
| return setMessages(update) |
There was a problem hiding this comment.
In this case, calculating the next version of the message data using the current state variable and passing that updated version to the state setter shouldn't cause any problems, but we still generally prefer using the callback style of setters. Using that approach, we pass a function to the setter whose parameter will receive the latest state value, and which returns the new value to use for the state.
setMessages(messages => messages.map(message => {
if (message.id === id) {
return {...message, liked: !message.liked};
} else {
return message;
};
}));We showed this approach in class, but technically, we're mixing a few responsibilities here. rather than this function needing to know how to change the liked status itself, we could move this update logic to a helper function. This would better mirror how we eventually update records when there's an API call involved.
In this project, our messages are very simple objects, but if we had more involved operations, it could be worthwhile to create an actual class with methods to work with them, or at least have a set of dedicated helper functions to centralize any such mutation logic.
| const numHearts = () => { | ||
| let count = 0; | ||
| for (const msg of messages) { | ||
| if (msg.liked === true) { | ||
| count++; | ||
| } | ||
| } | ||
| return count; | ||
| } |
There was a problem hiding this comment.
Nice job determining the total likes based on the like data of each message. We don't need an additional piece of state to track this, since it can be derived from the existing state we are tracking.
Explicitly totalling the count is perfectly fine, but many JS programmers would use reduce to achieve this.
Also, notice that we could move this helper entirely out of the component if we passed the current messages data as a parameter, rather than using enclosing scope to access it.
const numHearts = (messages) => {
return messages.reduce((count, msg) => {
return msg.liked ? count + 1 : count;
}, 0);
};The first few times we work with reduce, it can be challenging to understand, but it's a tool that gets used commonly enough that it's worth practicing.
| import TimeStamp from './TimeStamp'; | ||
| import { useState } from 'react'; | ||
|
|
||
| const ChatEntry = (props) => { |
There was a problem hiding this comment.
Personally, I like using destructured props to make it more visibly clear in the function definition itself what props we're expecting to receive. Even though we do need to remember that these are all passed in as a single object (your props parameter) and it can cause problems if we forget to include the destructuring syntax (it's easy to forget and list the props as multiple separate params), I really prefer the glanceability.
If you changed your approach to use destructuring here, you'd most likely want to be consistent across all your components.
No description provided.